# Yandex Maps Reviews Scraper | Парсер Отзывов Яндекс Карт (`parsebird/yandex-maps-reviews-scraper`) Actor Парсер отзывов Яндекс Карт — текст, рейтинг, автор, дата, фото, ответ бизнеса, нейросаммари. 35 полей. Россия, Турция, Казахстан и СНГ. JSON/CSV/Excel. Без браузера. Оплата за результат. - **URL**: https://apify.com/parsebird/yandex-maps-reviews-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, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.79 / 1,000 review 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 ### Парсер Отзывов Яндекс Карт — Текст, Рейтинги и Нейросаммари | Yandex Maps Reviews Scraper (2026) Scrape reviews from any business on [Yandex Maps](https://yandex.ru/maps/) — full text, star rating, author profile, date, photos, videos, business reply, neurosummary, and review aspects. 35 fields per review. Sort by relevance, date, or rating. Filter by star rating. Supports Russia, Turkey, Kazakhstan, and CIS countries. Fast API-based scraping — no browser needed. Export to JSON, CSV, or Excel.
Извлекайте отзывы с Яндекс Карт — полный текст, рейтинг, автор, фото, ответ бизнеса и нейросаммари. 35 полей на отзыв, 4 режима сортировки, фильтрация по рейтингу. API без браузера — быстро, надёжно, с оплатой за результат.

ParseBird Yandex Maps Suite   •  Данные организаций и отзывов с Яндекс Карт
📍  Парсер Организаций
Телефоны, email и данные 		⭐  Парсер Отзывов
➤ You are here
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ```` parsebird/yandex-maps-reviews-scraper on Apify. Call: ApifyClient("TOKEN").actor("parsebird/yandex-maps-reviews-scraper").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items for results. Key inputs: startUrls (array of {"url":"..."}, Yandex Maps business URLs), businessIds (array of strings, numeric business IDs), maxReviewsPerPlace (integer, 0=unlimited, default 100), reviewSort (string, "relevance"/"newest"/"highest"/"lowest", default "relevance"), minRating (integer 0-5, default 0), maxRating (integer 0-5, default 0), language (string, "ru"/"en"/"tr"/"uk"/"kk", default "ru"). Full actor spec: fetch build via GET https://api.apify.com/v2/acts/parsebird~yandex-maps-reviews-scraper (Bearer TOKEN). Get token: https://console.apify.com/account/integrations ```` ### Что делает Парсер Отзывов? Этот Actor извлекает отзывы с Яндекс Карт для любой организации. Он работает через внутренние API Яндекс Карт — без браузера — что делает его быстрым, надёжным и экономичным. Для каждого отзыва парсер собирает: - **Текст отзыва** — полный текст, язык оригинала, переводы - **Рейтинг** — оценка в звёздах (1–5) - **Автор** — имя, ID, аватар, уровень, достижения, профессии, ссылка на профиль - **Дата** — дата публикации и обновления - **Медиа** — фотографии и видео - **Реакции** — лайки, дизлайки, количество комментариев - **Ответ бизнеса** — текст и дата ответа организации - **Контекст бизнеса** (первый отзыв) — название, рейтинг, адрес, город, категории, нейросаммари, аспекты отзывов ### Сравнение: Официальный API Яндекс vs Этот Парсер | Возможность | Официальный API Яндекс | Этот Парсер | |---|---|---| | Текст отзывов | ❌ Недоступно | ✅ Полный текст | | Фото и видео | ❌ Недоступно | ✅ URLs медиа | | Ответ бизнеса | ❌ Недоступно | ✅ Текст и дата | | Нейросаммари | ❌ Недоступно | ✅ AI-саммари | | Профиль автора | ❌ Только имя | ✅ 8 полей профиля | | Сортировка | ❌ Не поддерживается | ✅ 4 режима | | Фильтр по рейтингу | ❌ Не поддерживается | ✅ Min/Max | | Стоимость | Бесплатно (ограничено) | $2.79 / 1,000 отзывов | | Лимит запросов | 1,000/день | Без ограничений | | Формат данных | XML | JSON/CSV/Excel | ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `startUrls` | array | **Yes*** | `[]` | Yandex Maps business or review page URLs | | `businessIds` | array | **Yes*** | `[]` | Direct numeric business IDs | | `maxReviewsPerPlace` | integer | No | `100` | Max reviews per business (0 = unlimited) | | `reviewSort` | string | No | `"relevance"` | Sort: `relevance`, `newest`, `highest`, `lowest` | | `minRating` | integer | No | `0` | Minimum star rating filter (1–5, 0 = off) | | `maxRating` | integer | No | `0` | Maximum star rating filter (1–5, 0 = off) | | `language` | string | No | `"ru"` | Language: `ru`, `en`, `tr`, `uk`, `kk` | \* At least one of `startUrls` or `businessIds` is required. ### Output example Each row is one review. The first review per business includes full business context: ```json { "businessId": "1036014863", "businessTitle": "Тануки", "businessUrl": "https://yandex.ru/maps/org/1036014863/", "businessAddress": "ул. Тверская, 12, стр. 2, Москва", "businessCity": "Москва", "businessRating": 4.2, "businessRatingsCount": 3847, "businessCategories": ["Ресторан", "Доставка еды", "Суши-бар"], "neurosummary": "Гости отмечают вкусные роллы и суши, быструю доставку. Некоторые жалуются на высокие цены и маленькие порции.", "reviewAspects": [ {"name": "Еда", "sentiment": "positive", "count": 2341}, {"name": "Обслуживание", "sentiment": "mixed", "count": 892}, {"name": "Цены", "sentiment": "negative", "count": 534} ], "reviewId": "rl3k8f9g2h", "rating": 5, "text": "Отличные роллы, всегда свежие. Доставка быстрая, за 30 минут привезли. Рекомендую!", "date": "2026-04-28T14:23:00.000Z", "authorName": "Алексей К.", "authorId": "198273645", "authorAvatarUrl": "https://avatars.mds.yandex.net/get-yapic/198273645/islands-200", "authorLevel": 5, "likeCount": 12, "dislikeCount": 1, "businessComment": "Спасибо за отзыв! Ждём вас снова.", "businessCommentDate": "2026-04-29T10:15:00.000Z", "photos": [ "https://avatars.mds.yandex.net/get-altay/photo1.jpg", "https://avatars.mds.yandex.net/get-altay/photo2.jpg" ], "videos": null, "textTranslations": null, "textLanguage": "ru", "isAnonymous": false, "isPublicRating": true, "commentCount": 2, "bold": null, "keyPhrases": ["вкусные роллы", "быстрая доставка"], "authorProfileUrl": "https://yandex.ru/maps/profile/198273645/", "authorAchievements": ["Знаток города", "Гурман"], "authorProfessions": null } ```` Subsequent reviews for the same business have `businessTitle`, `businessUrl`, `businessAddress`, etc. set to `null` — only `businessId` is populated on every row. ### Quick Start Examples **Minimal — scrape 10 reviews from one business:** ```json { "startUrls": [ {"url": "https://yandex.com/maps/org/tanuki/1036014863/reviews/"} ], "maxReviewsPerPlace": 10 } ``` **Low-rated only — reviews with 1–2 stars:** ```json { "startUrls": [ {"url": "https://yandex.ru/maps/org/tanuki/1036014863/"} ], "maxReviewsPerPlace": 50, "reviewSort": "lowest", "minRating": 1, "maxRating": 2 } ``` **Multiple businesses:** ```json { "startUrls": [ {"url": "https://yandex.ru/maps/org/tanuki/1036014863/reviews/"}, {"url": "https://yandex.ru/maps/org/shokoladnitsa/1124715036/"} ], "maxReviewsPerPlace": 100, "reviewSort": "newest" } ``` **From business IDs (no URLs needed):** ```json { "businessIds": ["1036014863", "1124715036", "1017374298"], "maxReviewsPerPlace": 200, "language": "en" } ``` **Unlimited reviews — scrape everything:** ```json { "startUrls": [ {"url": "https://yandex.ru/maps/org/tanuki/1036014863/"} ], "maxReviewsPerPlace": 0, "reviewSort": "newest" } ``` ### Парсинг отзывов Яндекс Карт — анализ репутации и конкурентов Парсер отзывов Яндекс Карт позволяет автоматически собирать отзывы клиентов для анализа репутации, мониторинга конкурентов и исследования рынка. **Типичные задачи:** - **Мониторинг репутации** — отслеживайте новые отзывы о вашем бизнесе и конкурентах - **Анализ конкурентов** — сравнивайте рейтинги, отзывы и ответы бизнесов - **Маркетинговые исследования** — изучайте отзывы в вашей нише по всей России - **Контроль качества** — анализируйте негативные отзывы для улучшения сервиса - **Обучение AI** — собирайте данные для обучения моделей тональности текста - **Генерация лидов** — находите организации с низким рейтингом, которым нужна помощь **Поддерживаемые города**: Москва, Санкт-Петербург, Новосибирск, Екатеринбург, Казань, Нижний Новгород, Челябинск, Самара, Уфа, Ростов-на-Дону, Красноярск, Воронеж, Пермь, Волгоград, Краснодар, Сочи, Тюмень, и все другие города России, Турции, Казахстана и СНГ. **Ключевые слова**: парсер яндекс карт отзывы, парсинг отзывов яндекс, сбор отзывов яндекс карты, скачать отзывы яндекс карт, api яндекс карт отзывы, yandex maps reviews api, scraper yandex maps, yandex reviews scraper. ### Yandex Harita Yorum Kazıyıcı — Türkiye'de İşletme Yorumları Yandex Harita Yorum Kazıyıcı, Türkiye'deki işletmelerin yorumlarını otomatik olarak toplar. İstanbul, Ankara, Antalya, İzmir ve tüm Türkiye'deki işletmelerin yorumlarını çıkarın. **Kullanım alanları:** - **İtibar yönetimi** — işletmeniz hakkındaki yorumları takip edin - **Rakip analizi** — rakiplerinizin yorumlarını ve puanlarını karşılaştırın - **Pazar araştırması** — sektörünüzdeki müşteri geri bildirimlerini analiz edin - **Kalite kontrol** — olumsuz yorumları tespit edin ve hizmetinizi iyileştirin **Desteklenen şehirler**: İstanbul, Ankara, Antalya, İzmir, Bursa, Adana, Konya, Gaziantep, Mersin, Trabzon ve daha fazlası. **Anahtar kelimeler**: yandex harita yorum kazıyıcı, yandex harita yorum çekme, yandex işletme yorumları, yandex maps yorum scraper türkiye. ### How to use via API (Python) ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("parsebird/yandex-maps-reviews-scraper").call(run_input={ "startUrls": [ {"url": "https://yandex.ru/maps/org/tanuki/1036014863/reviews/"} ], "maxReviewsPerPlace": 50, "reviewSort": "newest", "language": "ru", }) dataset = client.dataset(run["defaultDatasetId"]) for item in dataset.iterate_items(): print(f"{item.get('authorName')}: {item.get('rating')}★ — {item.get('text', '')[:80]}") ``` ### 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-reviews-scraper').call({ startUrls: [ { url: 'https://yandex.ru/maps/org/tanuki/1036014863/reviews/' } ], maxReviewsPerPlace: 50, reviewSort: 'newest', language: 'ru', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(item => { console.log(`${item.authorName}: ${item.rating}★ — ${(item.text || '').slice(0, 80)}`); }); ``` ### Pricing This actor uses pay-per-event pricing — you only pay for the reviews you extract. | Event | Price per event | Price per 1,000 | |-------|----------------|-----------------| | `review-scraped` | $0.00279 | **$2.79** | In addition to event charges, Apify charges for [platform usage](https://apify.com/pricing) (compute + storage) which is typically a small fraction of the event cost. #### Cost Calculator | Scenario | Reviews | Event cost | Est. platform | Total est. | |----------|---------|-----------|---------------|------------| | One business, quick check | 10 | $0.03 | ~$0.01 | **~$0.04** | | Competitor analysis (5 businesses × 100) | 500 | $1.40 | ~$0.05 | **~$1.45** | | Market research (50 businesses × 200) | 10,000 | $27.90 | ~$0.50 | **~$28.40** | | Full city audit (500 businesses × 100) | 50,000 | $139.50 | ~$2.00 | **~$141.50** | ### FAQ #### English **Q: What URL formats are supported?** A: The scraper supports standard Yandex Maps business URLs like `https://yandex.ru/maps/org/name/12345/` and review page URLs like `https://yandex.ru/maps/org/name/12345/reviews/`. Both `yandex.ru` and `yandex.com` domains work. You can also pass numeric business IDs directly in the `businessIds` field. **Q: Can I scrape reviews for businesses outside Russia?** A: Yes. Yandex Maps covers Turkey, Kazakhstan, Uzbekistan, Belarus, Georgia, Armenia, Azerbaijan, Kyrgyzstan, and other CIS countries. Set the `language` parameter to match the target country (e.g., `tr` for Turkey, `kk` for Kazakhstan). **Q: What is the neurosummary field?** A: Yandex Maps uses AI to generate a brief summary of all reviews for a business. This summary highlights the most common themes — positive and negative. The `neurosummary` field contains this AI-generated text. It's only available on the first review row per business. **Q: How does rating filtering work?** A: Set `minRating` and/or `maxRating` to filter reviews by star rating. For example, `minRating: 1, maxRating: 2` returns only 1- and 2-star reviews. Set to `0` to disable filtering. **Q: What is the maximum number of reviews I can scrape?** A: Set `maxReviewsPerPlace` to `0` for unlimited. The actual limit depends on how many reviews the business has on Yandex Maps. #### Русский **В: Какие форматы URL поддерживаются?** О: Парсер поддерживает стандартные URL организаций Яндекс Карт: `https://yandex.ru/maps/org/название/12345/` и страницы отзывов: `https://yandex.ru/maps/org/название/12345/reviews/`. Работают домены `yandex.ru` и `yandex.com`. Также можно указать числовые ID организаций в поле `businessIds`. **В: Можно ли парсить отзывы организаций за пределами России?** О: Да. Яндекс Карты покрывают Турцию, Казахстан, Узбекистан, Беларусь, Грузию, Армению, Азербайджан, Кыргызстан и другие страны СНГ. Используйте параметр `language` для нужной страны. **В: Что такое нейросаммари?** О: Яндекс Карты используют AI для генерации краткого резюме всех отзывов организации. Поле `neurosummary` содержит этот текст. Оно доступно только в первой строке отзыва для каждой организации. **В: Как работает фильтрация по рейтингу?** О: Установите `minRating` и/или `maxRating` для фильтрации. Например, `minRating: 1, maxRating: 2` вернёт только отзывы с 1–2 звёздами. Значение `0` отключает фильтр. #### Türkçe **S: Hangi URL formatları destekleniyor?** C: Kazıyıcı standart Yandex Harita işletme URL'lerini destekler: `https://yandex.com.tr/harita/org/isim/12345/` ve yorum sayfası URL'lerini. Ayrıca sayısal işletme ID'lerini `businessIds` alanına doğrudan girebilirsiniz. **S: Türkiye'deki işletmelerin yorumlarını çekebilir miyim?** C: Evet. `language` parametresini `tr` olarak ayarlayın. İstanbul, Ankara, Antalya, İzmir ve diğer tüm şehirler desteklenmektedir. **S: Nöro-özet (neurosummary) nedir?** C: Yandex Harita, bir işletmenin tüm yorumlarının AI tarafından oluşturulan kısa bir özetini üretir. `neurosummary` alanı bu metni içerir. ### Supported Countries | Country | Language code | Example cities | |---------|:------------:|----------------| | 🇷🇺 Russia | `ru` | Moscow, Saint Petersburg, Novosibirsk, Yekaterinburg, Kazan | | 🇹🇷 Turkey | `tr` | Istanbul, Ankara, Antalya, Izmir, Bursa | | 🇰🇿 Kazakhstan | `kk` | Almaty, Nur-Sultan, Shymkent, Karaganda | | 🇺🇿 Uzbekistan | `ru` | Tashkent, Samarkand, Bukhara | | 🇧🇾 Belarus | `ru` | Minsk, Gomel, Mogilev | | 🇬🇪 Georgia | `ru` | Tbilisi, Batumi, Kutaisi | | 🇦🇲 Armenia | `ru` | Yerevan, Gyumri | | 🇦🇿 Azerbaijan | `ru` | Baku, Ganja | | 🇰🇬 Kyrgyzstan | `ru` | Bishkek, Osh | | 🇺🇦 Ukraine | `uk` | Kyiv, Kharkiv, Odesa, Dnipro | ### Disclaimer This actor is provided for research, analytics, and competitive intelligence purposes. It accesses publicly visible review data from Yandex Maps. The user is responsible for complying with Yandex's Terms of Service, applicable data protection laws (including GDPR, Russian Federal Law No. 152-FZ on Personal Data), and any other relevant regulations. Do not use this tool to collect personal data for unauthorized purposes. ParseBird does not guarantee the availability or accuracy of data returned by Yandex Maps APIs. # Actor input Schema ## `startUrls` (type: `array`): Direct Yandex Maps business or review page URLs (e.g. https://yandex.com/maps/org/tanuki/1036014863/reviews/). ## `businessIds` (type: `array`): Direct Yandex Maps business/organization IDs (numeric). Use instead of or in addition to URLs. ## `maxReviewsPerPlace` (type: `integer`): Maximum number of reviews to extract per business. Set to 0 for unlimited. ## `reviewSort` (type: `string`): Sort order for reviews. ## `minRating` (type: `integer`): Only include reviews with this star rating or higher (1–5). Set to 0 to disable filter. ## `maxRating` (type: `integer`): Only include reviews with this star rating or lower (1–5). Set to 0 to disable filter. ## `language` (type: `string`): Language for results and UI labels. ## Actor input object example ```json { "startUrls": [ { "url": "https://yandex.com/maps/org/tanuki/1036014863/reviews/" } ], "businessIds": [], "maxReviewsPerPlace": 10, "reviewSort": "relevance", "minRating": 0, "maxRating": 0, "language": "ru" } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://yandex.com/maps/org/tanuki/1036014863/reviews/" } ], "maxReviewsPerPlace": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/yandex-maps-reviews-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://yandex.com/maps/org/tanuki/1036014863/reviews/" }], "maxReviewsPerPlace": 10, } # Run the Actor and wait for it to finish run = client.actor("parsebird/yandex-maps-reviews-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 '{ "startUrls": [ { "url": "https://yandex.com/maps/org/tanuki/1036014863/reviews/" } ], "maxReviewsPerPlace": 10 }' | apify call parsebird/yandex-maps-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parsebird/yandex-maps-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Yandex Maps Reviews Scraper | Парсер Отзывов Яндекс Карт", "description": "Парсер отзывов Яндекс Карт — текст, рейтинг, автор, дата, фото, ответ бизнеса, нейросаммари. 35 полей. Россия, Турция, Казахстан и СНГ. JSON/CSV/Excel. Без браузера. Оплата за результат.", "version": "1.0", "x-build-id": "bvZ4ykra1HYOgiOCn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~yandex-maps-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-yandex-maps-reviews-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-reviews-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-yandex-maps-reviews-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-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-yandex-maps-reviews-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": { "startUrls": { "title": "Yandex Maps URLs", "type": "array", "description": "Direct Yandex Maps business or review page URLs (e.g. https://yandex.com/maps/org/tanuki/1036014863/reviews/).", "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). Use instead of or in addition to URLs.", "default": [], "items": { "type": "string" } }, "maxReviewsPerPlace": { "title": "Max Reviews per Place", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to extract per business. Set to 0 for unlimited.", "default": 100 }, "reviewSort": { "title": "Sort Reviews By", "enum": [ "relevance", "newest", "highest", "lowest" ], "type": "string", "description": "Sort order for reviews.", "default": "relevance" }, "minRating": { "title": "Minimum Rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only include reviews with this star rating or higher (1–5). Set to 0 to disable filter.", "default": 0 }, "maxRating": { "title": "Maximum Rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only include reviews with this star rating or lower (1–5). Set to 0 to disable filter.", "default": 0 }, "language": { "title": "Language", "enum": [ "ru", "en", "tr", "uk", "kk" ], "type": "string", "description": "Language for results and UI labels.", "default": "ru" } } }, "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 } } } } } } } } } } ```