### Быстрый старт / Quick start
Email включён в примере и оплачивается дополнительно. Телефоны и email доступны не у всех организаций. Отзывы отключены для компактной выгрузки контактов.| Zen Studio · Maps & Business Data | ||
 Yandex MapsВы здесь |  Yandex ReviewsReviews & replies |  Apple MapsBusiness contacts |
München, Стамбул, 東京).
## `category` (type: `string`):
Select a common category. This adds an optimized search query in Russian for best results. You can combine this with custom queries above.
## `maxResults` (type: `integer`):
Maximum number of places for the whole run, shared across all your queries, not per query. 10 queries with 100 here return 100 places in total, not 1,000, so raise it when you add keywords. This is your main cost control: a place costs $0.00699, so 100 places is ~$0.70 and 1,000 is ~$7. 0 means unlimited, and a big city can hold tens of thousands of places, so an unlimited run keeps going until it reaches the maximum cost per run set for the run. Set a number here unless you truly want everything. | Общий лимит на весь запуск, а не на каждый запрос. 0 = без лимита, расход не ограничен.
## `language` (type: `string`):
Translates: addresses, categories, working hours, features, photo tags.https://yandex.com/maps/org/name/12345/https://yandex.com/maps/-/CPqIUMo (short share links)/reviews/ suffix. For search queries, use the Search queries field above.
## `businessIds` (type: `array`):
Direct Yandex business/organization IDs (numeric). Found in URLs like /org/name/17323657526/.
## `excludeBusinessIds` (type: `array`):
Business IDs to skip. Useful for recurring scrapes: pass the IDs you already collected in earlier runs, and you only get (and only pay for) places that are new to you.
## `coordinates` (type: `string`):
Exact center point as longitude,latitude (e.g. 37.622,55.753). Overrides the Location field. dLon,dLat. 0.01,0.01 ≈ 1km (Neighborhood)0.1,0.1 ≈ 10km (City center)0.5,0.5 ≈ 50km (Full city)
## `filterRating` (type: `string`):
Filter by minimum rating threshold.
## `filterOpenNow` (type: `boolean`):
Only show places currently open.
## `filterOpen24h` (type: `boolean`):
Only show places open 24/7.
## `filterDelivery` (type: `boolean`):
Only show places with food delivery.
## `filterTakeaway` (type: `boolean`):
Only show places with takeaway option.
## `filterWifi` (type: `boolean`):
Only show places with Wi-Fi.
## `filterCardPayment` (type: `boolean`):
Only show places accepting card payments.
## `filterParking` (type: `boolean`):
Only show places with parking.
## `filterPetFriendly` (type: `boolean`):
Only show pet-friendly places.
## `filterWheelchairAccess` (type: `boolean`):
Only show wheelchair-accessible places.
## `filterGoodPlace` (type: `boolean`):
Only show places with Yandex's "Good Place" badge.
## `filterMichelin` (type: `boolean`):
Only show Michelin-rated restaurants.
## `filterBusinessLunch` (type: `boolean`):
Only show restaurants offering business lunch.
## `filterSummerTerrace` (type: `boolean`):
Only show places with a summer terrace.
## `filterCuisine` (type: `array`):
Filter by cuisine type (e.g. italian, japanese, georgian).
## `filterPriceCategory` (type: `array`):
Filter by price level. Select one or more tiers.
## `filterPriceMin` (type: `integer`):
Minimum average bill (in local currency).
## `filterPriceMax` (type: `integer`):
Maximum average bill (in local currency).
## `filterCategories` (type: `array`):
Return only places in these categories. Pick as many as you need, a place matches if it belongs to any of them. Start typing to search the list.
## `searchScope` (type: `string`):
How far to look for a company's branches. One city searches the place in Location and is what every run does today. Whole country visits towns across the country instead of one city, for collecting a chain nationwide; it needs Chains to be set and a single search query, takes much longer, and returns many more places, so set Max results and a maximum cost per run before using it. Nationwide runs do not report whether every branch was found — see the run summary.
## `filterChainId` (type: `array`):
Return only branches of specific chains. Fill in Search queries and Location as well: Chains narrows a search, it does not replace one, so a broad word such as магазин or shop is all the query needs to be. | Заполните также «Запросы» и «Город»: поле «Сети» сужает поиск, а не заменяет его. Enter the chain name (Пятёрочка, Dodo Pizza), the chainId from a previous run, or a Yandex Maps page of any one branch (https://yandex.com/maps/org/name/12345/) to collect the rest of that company's branches. List as many companies as you need in one run, mixing all three forms. Max results is one budget shared by every chain listed, so allow enough for all of them or the last ones come back empty.
## `customFilters` (type: `array`):
Raw key:value filter strings for advanced filtering. Use when built-in filter fields don't cover your needs.
## `sortBy` (type: `string`):
Sort order for search results.
## `sortOrigin` (type: `string`):
Origin point for distance sorting as longitude,latitude. Only used when Sort by = Distance.
## `feedback` (type: `string`):
For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.
## Actor input object example
```json
{
"query": [
"restaurant"
],
"location": "Moscow",
"category": "",
"maxResults": 100,
"language": "ru",
"includeReviews": true,
"enrichBusinessData": false,
"maxPhotos": 0,
"maxPosts": 0,
"startUrls": [],
"businessIds": [],
"excludeBusinessIds": [],
"coordinates": "",
"viewportSpan": "",
"filterRating": "",
"filterOpenNow": false,
"filterOpen24h": false,
"filterDelivery": false,
"filterTakeaway": false,
"filterWifi": false,
"filterCardPayment": false,
"filterParking": false,
"filterPetFriendly": false,
"filterWheelchairAccess": false,
"filterGoodPlace": false,
"filterMichelin": false,
"filterBusinessLunch": false,
"filterSummerTerrace": false,
"filterCuisine": [],
"filterPriceCategory": [],
"filterCategories": [],
"searchScope": "city",
"filterChainId": [],
"customFilters": [],
"sortBy": "",
"sortOrigin": ""
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '