# Yandex Maps Scraper: Телефоны, Email и Отзывы (`parsebird/yandex-maps-scraper`) Actor

Парсер Яндекс Карт — телефоны, email, адреса, рейтинги, отзывы, фото организаций. Россия, Турция, Казахстан и СНГ. 60+ полей, экспорт JSON/CSV/Excel. Без браузера, без авторизации. Оплата за результат.

- **URL**: https://apify.com/parsebird/yandex-maps-scraper.md
- **Developed by:** [ParseBird](https://apify.com/parsebird) (community)
- **Categories:** Lead generation, SEO tools, Travel
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.79 / 1,000 place scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

### Парсер Яндекс Карт — Телефоны, Email и Отзывы | Yandex Maps Scraper (2026)

Extract business data from Yandex Maps at scale — phones, emails, addresses, ratings, reviews, photos, working hours, and 60+ more fields for any city in Russia, Turkey, Kazakhstan, and CIS countries. No browser required, no login needed. Pay only for results.

<table><tr>
<td style="border-left:4px solid #FC3F1D;padding:12px 16px;font-weight:600">
Собирайте базу организаций Яндекс Карт за минуты — телефоны, email, адреса, рейтинги, отзывы и фото. 60+ полей данных, экспорт в JSON, CSV, Excel. Без браузера, без авторизации, без лимитов.
</td>
</tr></table>

<table>
<tr>
<td colspan="2" style="padding:10px 14px;background:#FC3F1D;border:none;border-radius:4px 4px 0 0">
<span style="color:#FFFFFF;font-size:14px;font-weight:700;letter-spacing:0.5px">ParseBird Yandex Maps Suite</span>
<span style="color:#FFB3A0;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Организации и Отзывы</span>
</td>
</tr>
<tr>
<td style="padding:10px 14px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;border-right:none;border-top:none;vertical-align:top;width:50%;background:#FFF5F3">
📍 &nbsp;<a href="https://apify.com/parsebird/yandex-maps-scraper" style="color:#FC3F1D;text-decoration:none;font-weight:700;font-size:13px">Парсер Организаций</a><br>
<span style="color:#FC3F1D;font-size:11px;font-weight:600">&#10148; You are here</span>
</td>
<td style="padding:10px 14px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;border-top:none;vertical-align:top;width:50%">
⭐ &nbsp;<a href="https://apify.com/parsebird/yandex-maps-reviews-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Парсер Отзывов</a><br>
<span style="color:#78716C;font-size:11px">Все отзывы, рейтинги и анализ</span>
</td>
</tr>
</table>

##### Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

````

Apify Actor: parsebird/yandex-maps-scraper — extracts business data from Yandex Maps (phones, emails, addresses, ratings, reviews, photos, working hours, 60+ fields). Call via ApifyClient: client.actor("parsebird/yandex-maps-scraper").call(run\_input={"query": \["ресторан"], "location": "Москва", "maxResults": 100, "language": "ru", "maxReviews": 10, "maxPhotos": 0}). Inputs: query (array of search strings), location (city name, default "Москва"), startUrls (array of Yandex Maps URLs), businessIds (array of org IDs), maxResults (int, default 100), coordinates (string "lon,lat"), language (ru/en/tr/uk/kk), filterRating (gt4.5/gt4.0/gt3.5/gt3.0), filterOpenNow (bool), filterDelivery (bool), filterWifi (bool), maxReviews (int, default 10), maxPhotos (int, default 0). Output: dataset with businessId, title, rating, ratingsCount, phones, website, address, city, categories, reviews, photos, and 50+ more fields. API docs: https://docs.apify.com/api/v2 Token: https://console.apify.com/settings/integrations

````

### Что делает Парсер Яндекс Карт?

Парсер Яндекс Карт автоматически собирает данные об организациях с Яндекс Карт. Вы указываете поисковый запрос и город — парсер возвращает структурированные данные о каждой найденной организации.

**Возможности:**

- 🔍 **Поиск организаций** — по запросу и городу (например, «ресторан Москва», «автосервис Казань»)
- 📞 **Контактные данные** — телефоны, email, сайт, соцсети
- 📍 **Геоданные** — адрес, координаты, район, почтовый индекс
- ⭐ **Рейтинги и отзывы** — средний балл, количество оценок, тексты отзывов
- 🕐 **Режим работы** — расписание по дням, статус «открыто/закрыто»
- 📸 **Фото и видео** — ссылки на фотографии организации
- 🏷️ **Категории и характеристики** — Wi-Fi, доставка, парковка и другие
- 🔗 **Прямой доступ** — по URL или ID организации

### Input Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `query` | string[] | No* | — | Search queries (e.g. `["ресторан"]`) |
| `location` | string | No | `"Москва"` | City name for geo-targeting |
| `startUrls` | object[] | No* | `[]` | Direct Yandex Maps URLs |
| `businessIds` | string[] | No* | `[]` | Direct business/org IDs |
| `maxResults` | integer | No | `100` | Max places per query |
| `coordinates` | string | No | — | Override location as `"lon,lat"` |
| `language` | string | No | `"ru"` | Language: ru, en, tr, uk, kk |
| `filterRating` | string | No | — | Min rating: gt4.5, gt4.0, gt3.5, gt3.0 |
| `filterOpenNow` | boolean | No | `false` | Only businesses open now |
| `filterDelivery` | boolean | No | `false` | Only businesses with delivery |
| `filterWifi` | boolean | No | `false` | Only businesses with Wi-Fi |
| `maxReviews` | integer | No | `10` | Reviews per place (0 = skip) |
| `maxPhotos` | integer | No | `0` | Photos per place (0 = skip) |

*At least one of `query`, `startUrls`, or `businessIds` is required.

### Output Example

```json
{
    "businessId": "1124715036",
    "title": "Пушкинъ",
    "description": "Ресторан русской кухни в историческом особняке",
    "type": "business",
    "url": "https://yandex.ru/maps/org/1124715036/",
    "searchQuery": "ресторан",
    "longitude": 37.603856,
    "latitude": 55.764917,
    "address": "Россия, Москва, Тверской бульвар, 26А",
    "country": "Россия",
    "region": "Москва",
    "city": "Москва",
    "street": "Тверской бульвар",
    "house": "26А",
    "postalCode": "125009",
    "status": "open",
    "isOpenNow": true,
    "isVerifiedOwner": true,
    "rating": 4.6,
    "ratingsCount": 8542,
    "categories": ["Ресторан", "Банкетный зал"],
    "phones": ["+7 (495) 739-00-33"],
    "website": "https://cafe-pushkin.ru",
    "socialLinks": ["https://vk.com/cafepushkin"],
    "workingHoursText": "ежедневно, круглосуточно",
    "schedule": [],
    "features": {
        "wifi": true,
        "delivery": true,
        "parking": true
    },
    "photoCount": 245,
    "chainName": "",
    "chainId": "",
    "nearbyMetro": [],
    "reviews": [
        {
            "reviewId": "abc123",
            "author": "Анна К.",
            "rating": 5,
            "text": "Прекрасный ресторан с великолепной атмосферой...",
            "date": "2026-04-15"
        }
    ],
    "reviewCount": 1
}
````

### Quick Start

#### Minimal — search by query

```json
{
    "query": ["ресторан"],
    "location": "Москва",
    "maxResults": 50
}
```

#### With filters — high-rated open businesses with Wi-Fi

```json
{
    "query": ["кафе"],
    "location": "Санкт-Петербург",
    "maxResults": 100,
    "filterRating": "gt4.0",
    "filterOpenNow": true,
    "filterWifi": true,
    "maxReviews": 20
}
```

#### From URLs

```json
{
    "startUrls": [
        { "url": "https://yandex.ru/maps/org/pushkin/1124715036/" },
        { "url": "https://yandex.ru/maps/org/white-rabbit/1017413890/" }
    ],
    "maxReviews": 50
}
```

#### From business IDs

```json
{
    "businessIds": ["1124715036", "1017413890", "1094535053"],
    "language": "en",
    "maxReviews": 10
}
```

### Парсинг Яндекс Карт — сбор базы организаций, телефонов, отзывов

Парсер Яндекс Карт (Yandex Maps Scraper) — это инструмент для автоматического сбора данных об организациях с Яндекс Карт. Он позволяет собирать базу компаний по любому запросу и городу: рестораны, салоны красоты, автосервисы, медицинские центры, юридические компании и любые другие организации.

**Зачем нужен парсер Яндекс Карт?**

- **Сбор базы клиентов** — телефоны и email компаний для холодных продаж и маркетинга
- **Анализ конкурентов** — рейтинги, отзывы, цены и характеристики конкурирующих бизнесов
- **Маркетинговые исследования** — анализ рынка по городам и категориям
- **Геомаркетинг** — координаты и адреса для построения карт покрытия
- **Мониторинг репутации** — автоматический сбор новых отзывов

**Какие данные собирает парсер?**

Парсер извлекает более 60 полей для каждой организации: название, описание, телефоны, email, сайт, адрес (с разбивкой на город, улицу, дом), координаты, рейтинг, количество оценок, категории, режим работы, характеристики (Wi-Fi, доставка, парковка), фотографии, отзывы с текстом и оценкой, юридическую информацию и многое другое.

**Поддерживаемые города:** Москва, Санкт-Петербург, Новосибирск, Екатеринбург, Казань, Нижний Новгород, Красноярск, Челябинск, Самара, Уфа, Ростов-на-Дону, Краснодар и все другие города России, Турции, Казахстана и СНГ.

### Yandex Harita Kazıyıcı — Türkiye'de İşletme Verileri

Yandex Harita Kazıyıcı (Yandex Maps Scraper), Yandex Haritalar'dan işletme verilerini toplamak için kullanılan bir araçtır. Türkiye'deki her şehirde restoran, otel, kuaför, oto servis, hastane ve diğer işletmeleri arayabilir ve verilerini çıkarabilirsiniz.

**Ne tür veriler toplayabilirsiniz?**

- İşletme adı, açıklama, kategoriler
- Telefon numaraları, e-posta, web sitesi
- Adres, koordinatlar, posta kodu
- Puan, yorum sayısı, yorum metinleri
- Çalışma saatleri, Wi-Fi, teslimat bilgileri
- Fotoğraflar ve videolar

**Desteklenen şehirler:** İstanbul, Ankara, İzmir, Antalya, Bursa ve Türkiye'deki tüm diğer şehirler.

### How to Use via API — Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("parsebird/yandex-maps-scraper").call(
    run_input={
        "query": ["ресторан"],
        "location": "Москва",
        "maxResults": 100,
        "language": "ru",
        "maxReviews": 10,
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']} — {item['phones']} — {item['rating']}")
```

### How to Use via API — JavaScript

```javascript
import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "YOUR_API_TOKEN" });

const run = await client.actor("parsebird/yandex-maps-scraper").call({
    query: ["ресторан"],
    location: "Москва",
    maxResults: 100,
    language: "ru",
    maxReviews: 10,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.log(`${item.title} — ${item.phones} — ${item.rating}`);
});
```

### How It Works

1. **Geocoding** — resolves the city name to coordinates (built-in dictionary + Yandex geocoding API)
2. **Search** — queries the Yandex Maps internal search API for businesses matching your query in the target area
3. **Pagination** — iterates through search result pages until `maxResults` is reached
4. **Detail fetching** — for each found business, fetches the full organization card via the internal API (with HTML fallback)
5. **Reviews & Photos** — optionally fetches reviews and photo URLs per place
6. **Filtering** — applies rating, open-now, delivery, and Wi-Fi filters
7. **Output** — pushes structured data to the Apify dataset (export as JSON, CSV, or Excel)

### Pricing

| Event | Price per event | Price per 1,000 |
|-------|----------------|-----------------|
| `place-scraped` | $0.00679 | **$6.79** |

You are charged per place extracted. Reviews and photos included in the per-place price. [Apify Free plan](https://apify.com/pricing) includes $5/month platform credit.

### FAQ

#### English

**Q: Do I need a Yandex Maps API key?**
A: No. This actor uses Yandex Maps' internal web APIs — no API key required.

**Q: Which countries are supported?**
A: Russia, Turkey, Kazakhstan, Belarus, Ukraine, Uzbekistan, Azerbaijan, Georgia, Armenia, Kyrgyzstan, and all other countries covered by Yandex Maps.

**Q: How many results can I extract?**
A: There is no hard limit. Set `maxResults` to any value. The actor paginates automatically.

**Q: Can I extract reviews?**
A: Yes. Set `maxReviews` to the desired number of reviews per place (default: 10).

**Q: What format is the output?**
A: JSON by default. You can export to CSV or Excel from the Apify Console or API.

#### Русский

**В: Нужен ли API-ключ Яндекс Карт?**
О: Нет. Парсер использует внутренние веб-API Яндекс Карт — ключ не нужен.

**В: Какие города поддерживаются?**
О: Все города России, Турции, Казахстана, Беларуси, Украины и других стран СНГ.

**В: Сколько организаций можно собрать?**
О: Ограничений нет. Укажите нужное значение в `maxResults`. Парсер автоматически проходит по страницам.

**В: Можно ли собирать отзывы?**
О: Да. Укажите количество отзывов на организацию в `maxReviews` (по умолчанию: 10).

**В: В каком формате выгружаются данные?**
О: JSON по умолчанию. Можно экспортировать в CSV или Excel через консоль Apify или API.

#### Türkçe

**S: Yandex Haritalar API anahtarına ihtiyacım var mı?**
C: Hayır. Bu araç Yandex Haritalar'ın dahili web API'lerini kullanır — API anahtarı gerekmez.

**S: Hangi ülkeler destekleniyor?**
C: Rusya, Türkiye, Kazakistan, Belarus, Ukrayna, Özbekistan, Azerbaycan, Gürcistan, Ermenistan ve Yandex Haritalar'ın kapsadığı tüm ülkeler.

**S: Kaç sonuç çıkarabilirim?**
C: Sabit bir sınır yoktur. `maxResults` değerini istediğiniz sayıya ayarlayın.

### Supported Countries

| Country | Language | Example Cities |
|---------|----------|---------------|
| 🇷🇺 Russia | ru | Moscow, Saint Petersburg, Novosibirsk, Yekaterinburg, Kazan |
| 🇹🇷 Turkey | tr | Istanbul, Ankara, Izmir, Antalya, Bursa |
| 🇰🇿 Kazakhstan | kk | Almaty, Astana, Shymkent, Karaganda |
| 🇧🇾 Belarus | ru | Minsk, Gomel, Mogilev |
| 🇺🇦 Ukraine | uk | Kyiv, Kharkiv, Odesa, Dnipro |
| 🇺🇿 Uzbekistan | ru | Tashkent, Samarkand, Bukhara |
| 🇦🇿 Azerbaijan | ru | Baku, Ganja |
| 🇬🇪 Georgia | ru | Tbilisi, Batumi |
| 🇦🇲 Armenia | ru | Yerevan, Gyumri |
| 🇰🇬 Kyrgyzstan | ru | Bishkek, Osh |

### Disclaimer

This actor is designed for legitimate data collection purposes such as market research, lead generation, and competitive analysis. By using this actor, you agree to comply with Yandex Maps' Terms of Service and all applicable laws and regulations regarding data collection and usage. The actor accesses only publicly available information. The developer is not responsible for how extracted data is used. Always respect robots.txt, rate limits, and privacy regulations (GDPR, local data protection laws) when using scraped data.

# Actor input Schema

## `query` (type: `array`):

List of search queries to find businesses on Yandex Maps (e.g. 'ресторан', 'автосервис Москва').

## `location` (type: `string`):

City name for geo-targeting the search (e.g. 'Москва', 'Санкт-Петербург', 'Istanbul').

## `startUrls` (type: `array`):

Direct Yandex Maps URLs to scrape (e.g. https://yandex.ru/maps/org/1234567890/).

## `businessIds` (type: `array`):

Direct Yandex Maps business/organization IDs (numeric).

## `maxResults` (type: `integer`):

Maximum number of places to extract per search query.

## `coordinates` (type: `string`):

Override location with exact coordinates in 'longitude,latitude' format (e.g. '37.622504,55.753215' for Moscow).

## `language` (type: `string`):

Language for results and UI labels.

## `filterRating` (type: `string`):

Filter businesses by minimum rating threshold.

## `filterOpenNow` (type: `boolean`):

Only include businesses that are currently open.

## `filterDelivery` (type: `boolean`):

Only include businesses that offer delivery.

## `filterWifi` (type: `boolean`):

Only include businesses that offer Wi-Fi.

## `maxReviews` (type: `integer`):

Maximum number of reviews to extract per place. Set to 0 to skip reviews.

## `maxPhotos` (type: `integer`):

Maximum number of photo URLs to extract per place. Set to 0 to skip photos.

## Actor input object example

```json
{
  "query": [
    "ресторан"
  ],
  "location": "Москва",
  "startUrls": [],
  "businessIds": [],
  "maxResults": 5,
  "language": "ru",
  "filterRating": "",
  "filterOpenNow": false,
  "filterDelivery": false,
  "filterWifi": false,
  "maxReviews": 10,
  "maxPhotos": 0
}
```

# Actor output Schema

## `dataset` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": [
        "ресторан"
    ],
    "location": "Москва",
    "maxResults": 5,
    "maxReviews": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parsebird/yandex-maps-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": ["ресторан"],
    "location": "Москва",
    "maxResults": 5,
    "maxReviews": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parsebird/yandex-maps-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": [
    "ресторан"
  ],
  "location": "Москва",
  "maxResults": 5,
  "maxReviews": 10
}' |
apify call parsebird/yandex-maps-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parsebird/yandex-maps-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Yandex Maps Scraper: Телефоны, Email и Отзывы",
        "description": "Парсер Яндекс Карт — телефоны, email, адреса, рейтинги, отзывы, фото организаций. Россия, Турция, Казахстан и СНГ. 60+ полей, экспорт JSON/CSV/Excel. Без браузера, без авторизации. Оплата за результат.",
        "version": "1.0",
        "x-build-id": "OufJgtMthgUm8D4IM"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parsebird~yandex-maps-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parsebird-yandex-maps-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/parsebird~yandex-maps-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parsebird-yandex-maps-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/parsebird~yandex-maps-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parsebird-yandex-maps-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "query": {
                        "title": "Search Queries",
                        "type": "array",
                        "description": "List of search queries to find businesses on Yandex Maps (e.g. 'ресторан', 'автосервис Москва').",
                        "items": {
                            "type": "string"
                        }
                    },
                    "location": {
                        "title": "Location (City)",
                        "type": "string",
                        "description": "City name for geo-targeting the search (e.g. 'Москва', 'Санкт-Петербург', 'Istanbul').",
                        "default": "Москва"
                    },
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "Direct Yandex Maps URLs to scrape (e.g. https://yandex.ru/maps/org/1234567890/).",
                        "default": [],
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "businessIds": {
                        "title": "Business IDs",
                        "type": "array",
                        "description": "Direct Yandex Maps business/organization IDs (numeric).",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResults": {
                        "title": "Max Results per Query",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of places to extract per search query.",
                        "default": 100
                    },
                    "coordinates": {
                        "title": "Coordinates Override",
                        "type": "string",
                        "description": "Override location with exact coordinates in 'longitude,latitude' format (e.g. '37.622504,55.753215' for Moscow)."
                    },
                    "language": {
                        "title": "Language",
                        "enum": [
                            "ru",
                            "en",
                            "tr",
                            "uk",
                            "kk"
                        ],
                        "type": "string",
                        "description": "Language for results and UI labels.",
                        "default": "ru"
                    },
                    "filterRating": {
                        "title": "Minimum Rating",
                        "enum": [
                            "",
                            "gt4.5",
                            "gt4.0",
                            "gt3.5",
                            "gt3.0"
                        ],
                        "type": "string",
                        "description": "Filter businesses by minimum rating threshold.",
                        "default": ""
                    },
                    "filterOpenNow": {
                        "title": "Open Now",
                        "type": "boolean",
                        "description": "Only include businesses that are currently open.",
                        "default": false
                    },
                    "filterDelivery": {
                        "title": "Delivery Available",
                        "type": "boolean",
                        "description": "Only include businesses that offer delivery.",
                        "default": false
                    },
                    "filterWifi": {
                        "title": "Wi-Fi Available",
                        "type": "boolean",
                        "description": "Only include businesses that offer Wi-Fi.",
                        "default": false
                    },
                    "maxReviews": {
                        "title": "Max Reviews per Place",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of reviews to extract per place. Set to 0 to skip reviews.",
                        "default": 10
                    },
                    "maxPhotos": {
                        "title": "Max Photos per Place",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of photo URLs to extract per place. Set to 0 to skip photos.",
                        "default": 0
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
