🗺️ Yandex Maps Scraper

Организации, контакты, отзывы и цены — в одном датасете

Собирайте данные Яндекс Карт по поисковым запросам, ссылкам и ID организаций. Получайте структурированные карточки, изучайте отзывы и выгружайте результаты в Excel, CSV или JSON.

📍 Организации · ☎️ Телефоны · ✉️ Email · 💬 Отзывы · 🖼️ Медиа · 🍽️ Меню

Открыть в Apify Console · Быстрый старт · Примеры настроек · Запуск через API · English quick start

---

Быстрый старт

1. Откройте актор в Apify Console.
2. Перейдите в Input. В интерфейсе владельца это Source → Input.
3. В What to collect выберите Find businesses.
4. В Search queries введите запрос, например кофейни Казань.
5. Укажите количество результатов в Maximum output rows и выберите Язык данных / Data language.
6. Нажмите Start или Save & start.
7. Откройте Output, выберите нужную вкладку и нажмите Export.

Для первого запуска: запрос кофе Москва, 3 результата, язык Русский. Контакты и отзывы уже включены в стандартной форме.

Короткий маршрут: Input → Start → Output → Export.

Что вы получаете

Данные	Содержание	Основные поля
📍 Организация	Название, адрес, категории, координаты, рейтинг	businessId, title, address, categories, latitude, longitude, rating
☎️ Контакты	Телефоны карточки и сайта, опубликованные email, сайты и мессенджеры	phones, phonesNormalized, websitePhones, emails, websites, socialLinks
💬 Отзывы	Текст, оценка, дата, автор, реакции и ответ организации	reviews, reviewId, text, date, authorName, businessComment
🍽️ Меню и цены	Позиции меню или прайса, стоимость и валюта источника	menu, price, priceValue, currency, currencyCode
🖼️ Медиа	Фотографии, публикации, видео и логотип	photos, posts, videos, logoUrl
🕒 Информация о месте	График работы, удобства, метро и остановки рядом	workingHoursText, schedule, features, nearbyMetro, nearbyStops
🔗 Источники	Ссылки на карточку и страницы, где найдены контакты	sourceUrl, contactSources, fieldSources, scrapedAt

Телефоны из Яндекс Карт и телефоны бизнес-сайта представлены отдельно. Для дополнительных контактов сохраняется страница-источник — удобно проверять данные перед добавлением в CRM.

Как работает актор

Вы задаёте источник → актор находит карточки → собирает выбранные данные → сохраняет готовые результаты.

1. Поисковые фразы находят организации в выбранном городе или районе. Ссылки и ID открывают конкретные карточки.
2. Актор читает опубликованные сведения об организации: адрес, телефоны, рейтинг, график и категории.
3. Включённые настройки добавляют отзывы, меню, фотографии, публикации и контакты бизнес-сайта.
4. При включённой дедупликации одна организация сохраняется один раз, даже если встретилась в нескольких запросах.
5. Готовые карточки появляются в датасете по мере обработки. В режиме отзывов каждая строка представляет отдельный отзыв.

Выберите сценарий

Задача	Выбор в форме	scrapeType	Что будет в одной строке
Найти организации по запросу	Find businesses	search	Карточка организации
Получить данные известных мест	Business details from URLs or IDs	details	Карточка организации
Собрать отзывы для анализа	Reviews — one row per review	reviews	Отзыв с данными организации

Город можно указать прямо в запросе — стоматология Казань — или отдельно в Location. В последнем случае название города добавляется к каждой поисковой фразе.

Примеры настроек

Эти примеры можно вставить во вкладку Input → JSON или сохранить в файл input.json для запуска через API.

☕ Кофейни Казани с телефонами

{
  "scrapeType": "search",
  "query": ["кофейни Казань"],
  "maxItems": 20,
  "language": "ru",
  "requirePhone": true,
  "minRating": 4.5,
  "enrichContacts": true,
  "includeReviews": true,
  "maxReviews": 5
}

📌 Конкретные организации: контакты, меню и фотографии

{
  "scrapeType": "details",
  "businessIds": ["1036014863", "17323657526"],
  "maxItems": 2,
  "language": "ru",
  "enrichContacts": true,
  "includeMenu": true,
  "includeReviews": true,
  "maxReviews": 5,
  "maxPhotos": 3,
  "maxPosts": 3
}

Вместо ID можно заполнить Yandex Maps links:

{
  "scrapeType": "details",
  "startUrls": [
    {
      "url": "https://yandex.ru/maps/org/tanuki/1036014863/"
    }
  ],
  "maxItems": 1,
  "language": "ru",
  "includeMenu": true
}

💬 Свежие отзывы отеля — отдельными строками

{
  "scrapeType": "reviews",
  "businessIds": ["17323657526"],
  "maxItems": 50,
  "maxReviews": 50,
  "reviewSort": "newest",
  "language": "ru"
}

Такой формат удобно экспортировать в Excel: текст, оценка, дата, автор и ответ организации находятся в отдельных столбцах.

Настройки под вашу задачу

Настройка	Что делает
query	Поисковые фразы: одна фраза на элемент списка
location	Город или район, добавляемый к запросам
startUrls / businessIds	Прямой выбор организаций по ссылкам или ID
maxItems	Количество строк для всего запуска: организаций либо отзывов, в зависимости от сценария
language	Язык метаданных
enrichContacts	Дополнительные контакты из бизнес-сайта и ответов организации
includeReviews / maxReviews	Сбор отзывов и их количество на организацию
reviewSort	Порядок отзывов: relevance, newest, highest, lowest
reviewsSince	Отзывы с датой источника позже указанного момента, например 2026-01-01T00:00:00Z
includeMenu	Меню или прайс организации
maxPhotos / maxPosts	Количество фотографий и публикаций на карточку
requirePhone / requireWebsite	Отбор организаций с телефоном или сайтом
minRating	Минимальная оценка организации; в режиме отзывов — оценка отзыва
filterOpenNow	Организации, отмеченные источником как открытые сейчас
deduplicate	Удаление повторяющихся организаций или отзывов
excludeBusinessIds	Пропуск организаций, которые уже есть в вашей базе

Поисковые фразы обрабатываются по очереди и используют общее значение maxItems.

🌐 Языки и региональная валюта

В Язык данных / Data language доступны:

Язык	Значение для API
Русский — по умолчанию	ru
English	en
Türkçe	tr
Қазақша	kk
Українська	uk
Azərbaycanca	az

Язык применяется к адресам, категориям и другим метаданным, которые Яндекс выдаёт в выбранной локализации. Оригинальный текст отзыва сохраняется в text, а оригинал на выбранном языке или предоставленный Яндексом перевод — в textInRequestedLanguage.

Валюта относится к цене организации и сохраняется при смене языка. Например, выбор английского для московской карточки оставляет рубли, а выбор русского для алматинской — тенге.

Цена источника	Код валюты
₽ — российский рубль	RUB
₸ — казахстанский тенге	KZT
Br — белорусский рубль	BYN
₺ / турецкая лира	TRY

В меню сохраняются исходные price и currency; для обработки добавлены priceValue, currencyRaw и currencyCode. Поле currencies содержит обнаруженные коды валют. Суммы остаются в валюте источника, без пересчёта по курсу.

Пример результата

Сокращённый фрагмент реальной тестовой карточки:

{
  "businessId": "69353267050",
  "title": "Surf Coffee x Flow",
  "address": "Москва, Страстной бул., 8А",
  "phones": [
    "+7 (993) 337-56-86"
  ],
  "emails": [
    "hello@surfcoffee.ru"
  ],
  "website": "https://surfcoffee.ru/",
  "currency": "RUB",
  "menu": {
    "items": [
      {
        "title": "Пирожное Картошка классическая",
        "price": "195",
        "currency": "₽",
        "currencyCode": "RUB"
      }
    ]
  }
}

📊 Просмотр и экспорт

В Output данные распределены по вкладкам:

Вкладка	Для чего использовать
Businesses	Список организаций: адреса, оценки, контакты и валюта
Contacts	Работа с телефонами, email, сайтами и мессенджерами
Reviews	Анализ отзывов и ответов организации
Photos, posts & menus	Медиа, публикации и прайсы
Location & features	География, график работы и характеристики места
Sources & collection status	Проверка источников и сведений о сборе

Нажмите Export и выберите Excel, CSV или JSON. Для анализа отзывов в таблицах выбирайте сценарий Reviews — one row per review. Для сохранения структуры карточки вместе с меню и медиа используйте JSON.

Продолжение выгрузки организаций

1. Откройте Storage → Key-value store завершённого запуска.
2. Откройте запись RESUME_INPUT.
3. Скопируйте её JSON в Input нового запуска.
4. Нажмите Start.

Продолжение использует сохранённую позицию поиска и исключает уже записанные ID. Итоги обработки находятся в записи OUTPUT того же хранилища.

Для готовых интеграций в Export field format предусмотрены extended, zen и mamaev. Они позволяют выбрать нужное представление полей при работе с существующими таблицами и сценариями.

Запуск через API

API удобно использовать для интеграции с CRM, собственным приложением или обработкой данных на Python.

1. Установите клиент Apify:

$pip install apify-client

2. Сохраните один из примеров выше в input.json и передайте API-токен через переменную окружения APIFY_TOKEN.

3. Сохраните этот код в run_actor.py:

import asyncio
import json
import os
from pathlib import Path

from apify_client import ApifyClientAsync


async def main():
    client = ApifyClientAsync(os.environ["APIFY_TOKEN"])
    actor_input = json.loads(
        Path("input.json").read_text(encoding="utf-8-sig")
    )

    run = await client.actor("trakk/yandex-maps-scraper").call(
        run_input=actor_input
    )
    if not run or run["status"] != "SUCCEEDED":
        raise RuntimeError("Check the run details in Apify Console.")

    dataset = await client.dataset(run["defaultDatasetId"]).list_items(
        clean=True
    )
    Path("results.json").write_text(
        json.dumps(dataset.items, ensure_ascii=False, indent=2),
        encoding="utf-8",
    )
    print(f"Saved {len(dataset.items)} records to results.json")


if __name__ == "__main__":
    asyncio.run(main())

4. Укажите токен и запустите скрипт:

Windows — PowerShell:

$env:APIFY_TOKEN = "YOUR_APIFY_TOKEN"
py run_actor.py

macOS / Linux:

export APIFY_TOKEN="YOUR_APIFY_TOKEN"
python run_actor.py

Замените YOUR_APIFY_TOKEN своим токеном из настроек Apify. Скрипт запускает актор, ожидает завершения и сохраняет датасет в results.json с читаемым Unicode.

---

English quick start

Collect Yandex Maps businesses, published contacts, reviews, photos, posts and menu prices in a structured dataset.

1. Open the Actor in Apify Console and go to Input.
2. Choose Find businesses, enter a query such as coffee Moscow, and set Maximum output rows.
3. Select your Data language and the data you want to collect.
4. Click Start, then open Output.
5. Use Export to download Excel, CSV or JSON.

Use search for queries, details for business links or IDs, and reviews for one review per row. The JSON examples above can be pasted directly into the input editor; set language to en for English metadata.

maxItems is the row count for the entire run. maxReviews controls reviews per business. Contact evidence is available in contactSources; business-site phone numbers are separated into websitePhones.

Prices retain their original currency when the data language changes. Source-provided review translations are returned separately from the original text. For repeat business collections, use the generated RESUME_INPUT record or provide previously collected IDs in excludeBusinessIds.

The Python example above starts the Actor through the Apify API and saves its output locally.