# Yandex

Your Toolhouse AI Worker can connect to Yandex using 21 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=yandex).

## Tools (21)

### `Yandex Geocoder Reverse`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Yandex Get Account Experiments`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Yandex Get Account Status`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Yandex Get Genres`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Yandex Get Permission Alerts`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Yandex Get Playlists Ids By Tag`

Integration name: **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'.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Yandex Get Public Resource`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Yandex Get Public Resource Download Link`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                     | Description                                                                                                                                        |
| ------------ | ------ | :------: | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`       | string |          | `"documents/report.pdf"`                    | 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 |          | `"href,method"`                             | Comma-separated list of attributes to return in the response. If not specified, all available attributes are returned.                             |
| `public_key` | string |     ✅    | `"https://disk.yandex.ru/d/3TNxutqLD1ZqdA"` | 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>'). |

***

### `Yandex Get Rotor Account Status`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Yandex Get Rotor Stations Dashboard`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Yandex Get Settings`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Yandex Get Stations List`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Yandex Get Track Download Info`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Yandex List Filters`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example    | Description                              |
| ------------ | ------- | :------: | ---------- | ---------------------------------------- |
| `counter_id` | integer |     ✅    | `44147844` | Counter ID for which to retrieve filters |

***

### `Yandex List Goals`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Yandex List Grants`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example    | Description                                           |
| ------------ | ------- | :------: | ---------- | ----------------------------------------------------- |
| `callback`   | string  |          | —          | JSONP callback function name (optional)               |
| `counter_id` | integer |     ✅    | `44147844` | Counter ID for which to retrieve grants (permissions) |

***

### `Yandex List Log Requests`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Yandex List Storage Buckets`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Yandex Organization Search`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example                  | Description                                                                                                                              |
| --------- | ------- | :------: | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `ll`      | string  |          | —                        | Longitude,latitude of search center. Used with spn or bbox to bound search area.                                                         |
| `spn`     | string  |          | —                        | Longitude span,latitude span for search area. Used with ll.                                                                              |
| `uri`     | string  |          | —                        | Identifier from previous geosuggest result. If set, text is ignored.                                                                     |
| `bbox`    | string  |          | —                        | Bounding box as 'lon1,lat1\~lon2,lat2'. Overrides ll+spn if provided.                                                                    |
| `lang`    | string  |          | `"en_US"`                | 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 |          | —                        | Restrict search to defined area (ll+spn or bbox). True to restrict, False to allow outside search.                                       |
| `skip`    | integer |          | —                        | Number of results to skip. Must be a multiple of `results` if > 0.                                                                       |
| `text`    | string  |     ✅    | `"Museum of The Future"` | Search query text: business name, address, TIN, coordinates, or phone number.                                                            |
| `type`    | string  |          | —                        | Type of search results; fixed to 'biz' for organization search.                                                                          |
| `apikey`  | string  |     ✅    | `"YOUR_API_KEY"`         | API key issued in the Yandex Developer Dashboard for Places API. Activation takes up to 15 minutes.                                      |
| `results` | integer |          | —                        | Maximum number of results to return (1-50). Default is 10.                                                                               |

***

### `Yandex Route`

Integration name: **YANDEX\_ROUTE**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Yandex Tiles`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                  | Description                                                                                                                                                                           |
| ------------ | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `l`          | string  |     ✅    | —                                        | Map layer type. Only 'map' (roadmap) is supported.                                                                                                                                    |
| `x`          | integer |     ✅    | —                                        | Tile number on the X axis (calculate per docs).                                                                                                                                       |
| `y`          | integer |     ✅    | —                                        | Tile number on the Y axis (calculate per docs).                                                                                                                                       |
| `z`          | integer |     ✅    | `16`                                     | Zoom level, integer from 0 (whole world) up to 20 (street level).                                                                                                                     |
| `lang`       | string  |     ✅    | `"en_US"`                                | Map caption language and region, in ISO 639-1\_language + ISO 3166-1\_region format. Determines feature-label language and regional settings.                                         |
| `scale`      | number  |          | —                                        | 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  |          | `"bb292a97-4b68-4467-9235-01c2faac8a06"` | 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"`                                  | Predefined map style mode (default 'map').                                                                                                                                            |
| `projection` | string  |          | `"wgs84_mercator"`                       | Projection: 'wgs84\_mercator' for elliptical Mercator (default), 'web\_mercator' for spherical Web Mercator.                                                                          |

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/yandex.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.