> For the complete documentation index, see [llms.txt](https://docs.toolhouse.ai/toolhouse/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toolhouse.ai/toolhouse/integrations/yandex.md). # 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., '') | | `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., ''). | *** ### `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. | ***