# Yandex

Yandex is a Russian internet services provider offering search, email, navigation, and other web-based solutions, often referred to as “Russia’s Google”

- **Category:** email
- **Auth:** OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 21
- **Triggers:** 0
- **Slug:** `YANDEX`
- **Version:** 20260223_00

## Tools

### Reverse Geocode Coordinates

**Slug:** `YANDEX_GEOCODER_REVERSE`

Tool to convert geographic coordinates to a human-readable address (reverse geocoding). Returns address information including street, city, country, and other location details. Use this when you have latitude/longitude coordinates and need to find the corresponding address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kind` | string ("house" | "street" | "metro" | "district" | "locality") | No | Filter results by toponym type (house, street, metro, district, locality) |
| `lang` | string ("ru_RU" | "uk_UA" | "be_BY" | "en_RU" | "en_US" | "tr_TR") | No | Preferred language and region for the response in format language_region |
| `apikey` | string | Yes | Yandex Maps HTTP Geocoder API key. Get your key from Yandex Developer Dashboard. |
| `format` | string | No | Response format; only 'json' is supported |
| `latitude` | number | Yes | Latitude of the location in decimal degrees (range: -90 to 90) |
| `longitude` | number | Yes | Longitude of the location in decimal degrees (range: -180 to 180) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Experiments

**Slug:** `YANDEX_GET_ACCOUNT_EXPERIMENTS`

Tool to retrieve Yandex Music account experimental features and A/B testing flags. Use when you need to check which experimental features are enabled for an account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Status

**Slug:** `YANDEX_GET_ACCOUNT_STATUS`

Tool to retrieve Yandex Music account status and permissions. Use when you need to check account availability, region, subscription status, and granted permissions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Music Genres

**Slug:** `YANDEX_GET_GENRES`

Tool to retrieve the list of music genres from Yandex Music. Use when you need to get available music genres for browsing or categorization.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Permission Alerts

**Slug:** `YANDEX_GET_PERMISSION_ALERTS`

Tool to retrieve permission alerts and notifications from Yandex Music API. Use this to check for system notifications about subscription status, permissions, or other user alerts.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Playlists by Tag

**Slug:** `YANDEX_GET_PLAYLISTS_IDS_BY_TAG`

Tool to retrieve playlist IDs associated with a specific tag. Use when you need to find playlists categorized under a tag like 'rock', 'pop', or 'jazz'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_id` | string | Yes | Tag identifier to get playlist IDs for. Examples: 'rock', 'pop', 'jazz' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Public Resource Metadata

**Slug:** `YANDEX_GET_PUBLIC_RESOURCE`

Tool to retrieve metadata for a public file or folder on Yandex Disk. Use when you need to get information about publicly shared resources including their properties, nested items, and download URLs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | No | Path to a resource within the public folder (relative to the folder root). |
| `sort` | string | No | Field to sort nested resources by (e.g., 'name', 'created', 'modified', 'size'). Prefix with '-' for descending order. |
| `limit` | integer | No | Maximum number of nested resources to return. Use for paginating through folder contents. |
| `fields` | string | No | Comma-separated list of attributes to return. If not specified, all available attributes are returned. |
| `offset` | integer | No | Offset from the beginning of the nested resources list. Use with limit for pagination. |
| `public_key` | string | Yes | Public key or public URL of the resource (e.g., 'https://disk.yandex.ru/d/3LwGaY3ast26ig') |
| `preview_crop` | boolean | No | Whether to allow cropping the preview image. Set to true to enable preview cropping. |
| `preview_size` | string | No | Size of the preview image (e.g., 'S', 'M', 'L', 'XL', '100x100'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Public Resource Download Link

**Slug:** `YANDEX_GET_PUBLIC_RESOURCE_DOWNLOAD_LINK`

Tool to get a direct download link for a publicly shared Yandex Disk resource. Use when you need to download a file or folder that has been shared publicly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | No | Path to a specific resource within a public folder. Use this to get a download link for a file inside a shared folder. |
| `fields` | string | No | Comma-separated list of attributes to return in the response. If not specified, all available attributes are returned. |
| `public_key` | string | Yes | Public key or public URL of the resource to download. This is the share link from Yandex Disk (e.g., 'https://disk.yandex.ru/d/3TNxutqLD1ZqdA'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rotor Account Status

**Slug:** `YANDEX_GET_ROTOR_ACCOUNT_STATUS`

Tool to retrieve authenticated user's rotor account status with supplementary fields. Use to check user subscription status, permissions, and radio-specific settings like skips_per_hour.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rotor Stations Dashboard

**Slug:** `YANDEX_GET_ROTOR_STATIONS_DASHBOARD`

Tool to retrieve recommended radio stations for the current user. Use when you need to get the user's personalized station dashboard.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Yandex Music Settings

**Slug:** `YANDEX_GET_SETTINGS`

Tool to retrieve Yandex Music settings including available purchase products and payment configuration. Use when you need to check available subscription options, pricing, or payment methods.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Yandex Music Stations List

**Slug:** `YANDEX_GET_STATIONS_LIST`

Tool to retrieve all radio stations with user settings from Yandex Music. Use when you need to get the list of available radio stations and their configurations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language for station information. Common values: 'ru' for Russian, 'en' for English, 'uk' for Ukrainian. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Track Download Info

**Slug:** `YANDEX_GET_TRACK_DOWNLOAD_INFO`

Tool to retrieve available download options for a Yandex Music track. Returns a list of download variants with different codecs (MP3/AAC) and bitrates. Use this when you need to get download links for a specific track ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trackId` | string | Yes | Unique identifier of the track to retrieve download information for. Use the track ID from Yandex Music. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Filters

**Slug:** `YANDEX_LIST_FILTERS`

Tool to retrieve all filters configured for a Yandex Metrica counter. Use when you need to view existing filters for data filtering or analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `counter_id` | integer | Yes | Counter ID for which to retrieve filters |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Goals

**Slug:** `YANDEX_LIST_GOALS`

Tool to retrieve all goals configured for a Yandex Metrica counter. Use when you need to list or inspect goals for analytics tracking.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `counter_id` | integer | Yes | Counter ID to retrieve goals for. This is the unique identifier of the Yandex Metrica counter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Counter Grants

**Slug:** `YANDEX_LIST_GRANTS`

Tool to retrieve the list of permissions (grants) for a Yandex Metrica counter. Use when you need to check who has access to view or manage a counter and their permission levels.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `callback` | string | No | JSONP callback function name (optional) |
| `counter_id` | integer | Yes | Counter ID for which to retrieve grants (permissions) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Log Requests

**Slug:** `YANDEX_LIST_LOG_REQUESTS`

Tool to retrieve a list of log requests for a Yandex Metrica counter. Use when you need to view all log requests associated with a specific counter ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `counterId` | integer | Yes | Counter ID (tag ID) for which to retrieve log requests |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Storage Buckets

**Slug:** `YANDEX_LIST_STORAGE_BUCKETS`

Tool to list all Yandex Object Storage buckets owned by the authenticated user. Use when you need to retrieve a list of available S3-compatible storage buckets.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Organization Search

**Slug:** `YANDEX_ORGANIZATION_SEARCH`

Tool to find businesses and organizations by name, address, or TIN. Use when you need to search for companies in a specific region or text query.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ll` | string | No | Longitude,latitude of search center. Used with spn or bbox to bound search area. |
| `spn` | string | No | Longitude span,latitude span for search area. Used with ll. |
| `uri` | string | No | Identifier from previous geosuggest result. If set, text is ignored. |
| `bbox` | string | No | Bounding box as 'lon1,lat1~lon2,lat2'. Overrides ll+spn if provided. |
| `lang` | string ("ru_RU" | "uk_UA" | "be_BY" | "en_RU" | "en_US" | "tr_TR") | No | Preferred response language and regional settings in format language_region. Supported: ru_RU, uk_UA, be_BY, en_RU, en_US, tr_TR. |
| `rspn` | boolean | No | Restrict search to defined area (ll+spn or bbox). True to restrict, False to allow outside search. |
| `skip` | integer | No | Number of results to skip. Must be a multiple of `results` if > 0. |
| `text` | string | Yes | Search query text: business name, address, TIN, coordinates, or phone number. |
| `type` | string | No | Type of search results; fixed to 'biz' for organization search. |
| `apikey` | string | Yes | API key issued in the Yandex Developer Dashboard for Places API. Activation takes up to 15 minutes. |
| `results` | integer | No | Maximum number of results to return (1-50). Default is 10. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate detailed route

**Slug:** `YANDEX_ROUTE`

Tool to generate detailed route for driving, walking, or public transport. Use when planning a route between specified geographic points.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("driving" | "truck" | "walking" | "transit" | "bicycle" | "scooter") | No | Transport mode for the route. |
| `width` | number | No | Vehicle width in meters (truck only). |
| `apikey` | string | Yes | Yandex Maps API key. Activation may take up to 15 minutes. |
| `height` | number | No | Vehicle height in meters (truck only). |
| `length` | number | No | Vehicle length in meters (truck only). |
| `levels` | string | No | Comma-separated floor levels per waypoint (must match number of waypoints). Available for walking and transit modes on paid plans. |
| `weight` | number | No | Vehicle weight in tons (truck only). |
| `payload` | number | No | Vehicle load capacity in tons (truck only). |
| `traffic` | string | No | Disable traffic-aware routing (only for driving or truck modes). |
| `eco_class` | integer | No | Vehicle emission standard (truck only). |
| `waypoints` | string | Yes | Route waypoints in WGS84 'latitude,longitude' format separated by '\|'. Use up to 50 points for driving/truck modes, and up to 25 for other modes. |
| `max_weight` | number | No | Maximum allowed vehicle weight in tons (truck only). |
| `avoid_tolls` | boolean | No | Avoid toll roads (only for driving or truck modes). |
| `avoid_zones` | array | No | Polygons to avoid during routing, each formatted as 'lat,lon\|lat,lon\|...'. Only for driving or truck modes. |
| `axle_weight` | number | No | Vehicle axle load in tons (truck only). |
| `has_trailer` | boolean | No | Indicates if the vehicle has a trailer (truck only). |
| `departure_time` | integer | No | Departure time as UNIX timestamp in seconds. Ignored for walking, bicycle, or scooter modes, or when traffic is disabled. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Yandex Tiles API

**Slug:** `YANDEX_TILES`

Tool to fetch individual map tile images by x/y coordinates and zoom level. Use after calculating tile indices for custom map rendering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `l` | string | Yes | Map layer type. Only 'map' (roadmap) is supported. |
| `x` | integer | Yes | Tile number on the X axis (calculate per docs). |
| `y` | integer | Yes | Tile number on the Y axis (calculate per docs). |
| `z` | integer | Yes | Zoom level, integer from 0 (whole world) up to 20 (street level). |
| `lang` | string ("ru_RU" | "en_RU" | "en_US" | "uk_UA" | "ru_UA" | "tr_TR") | Yes | Map caption language and region, in ISO 639-1_language + ISO 3166-1_region format. Determines feature-label language and regional settings. |
| `scale` | number | No | Scale factor for tile image size (range: 0.1-4.0). Values >1.0 produce larger hi-res tiles (e.g., 512x512 for scale=2), values <1.0 shrink the tile. Default is 1.0 (256x256 pixels). |
| `apikey` | string | No | Developer API key issued in the Yandex Developer Dashboard. Activation may take up to 15 minutes. If not provided, will attempt to use the API key from the connected account. |
| `maptype` | string ("map" | "future_map" | "driving" | "transit" | "admin") | No | Predefined map style mode (default 'map'). |
| `projection` | string ("wgs84_mercator" | "web_mercator") | No | Projection: 'wgs84_mercator' for elliptical Mercator (default), 'web_mercator' for spherical Web Mercator. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |