2gis Places Scraper

🗺️ Что такое парсер 2ГИС?

2GIS Places Scraper позволяет извлекать бизнес-данные из 2ГИС, помогая вам генерировать лиды, анализировать конкурентов и стимулировать рост всего за несколько кликов.

Возможности:

• Генерируйте квалифицированные лиды: извлекайте названия компаний, веб-сайты, адреса электронной почты и номера телефонов для создания списков потенциальных клиентов для вашей команды продаж.
• Отслеживайте конкурентов в разных регионах: контролируйте, где работают конкуренты, какие у них рейтинги и сколько отзывов они получили.
• Проведите анализ рынка: проанализируйте насыщенность рынка, выявите пробелы в предоставлении услуг или сравните местные предприятия по размеру, рейтингу и узнаваемости.
• Поддержка партнерских отношений: найдите лучшие или наиболее посещаемые места для проведения информационно-просветительской работы и сотрудничества.
• Автоматизируйте исследовательские процессы: замените задачи ручного поиска повторяющимися рабочими процессами, которые обеспечивают актуальность и согласованность наборов данных.

📦 Какие данные извлекает парсер 2ГИС?

• id: Идентификатор организации в 2ГИС
• title, shortName, extension: Название
• url: Ссылка на место в 2ГИС
• rubrics, category: Категории, рубрики
• totalScore, reviewsCount, ratingCount: Рейтинг, количество отзывов, количество оценок
• summary: Описание места на основе отзывов
• postcode, country, region, city, district, street, houseNumber, address: Подробная информация об адресе
• mainPhotoUrl: Фото
• location: координаты ("lat", "lng")
• working_hours: Рабочее время
• nearestStations: Ближайшие станции метро и расстояние до них
• attributeGroups: Дополнительная информация (Средний чек и т.д.)
• brand: name, branchCount, rating: Информация о бренде

🔌 Дополнительно:

• phoneText, phoneValue: Телефоны
• email: электронная почта
• website: ссылки на сайты
• socials: ссылки на социальные сети (vk, telegram, whatsapp, other)
• searchString, searchUrl, pageNumber, scrapedAt: данные о поиске

⬇️ INPUT

В качестве входных данных для парсера 2ГИС следует использовать местоположение в сочетании с поисковым запросом. Ввод можно настроить программно или через интерфейс актора.

🔍 Поисковые запросы

Использование нескольких похожих поисковых запросов может увеличить количество найденных мест, но также увеличивает время выполнения запроса. Мы рекомендуем использовать комбинацию поисковых запросов, которые отличаются друг от друга или лишь незначительно пересекаются по значению. Использование длинного списка повторяющихся поисковых запросов только увеличит время выполнения запроса, не предоставляя дополнительных результатов.

Пример хорошего списка поисковых запросов: [ ресторан, бар, паб, кафе, буфет, мороженое, чай ]

Пример некорректного списка поисковых запросов: [ ресторан, рестораны, китайские рестораны ]

📍 Поиск без геолокации

Вместо стандартных полей для ввода поискового запроса и местоположения вы также можете использовать только поисковый запрос (например, "рестораны в Москве") без поля ввода местоположения. Однако такой подход ограничит количество результатов до 60, поскольку открывает только один экран карты 2ГИС с ограниченным диапазоном прокрутки. Мы рекомендуем пропускать поле ввода местоположения только в том случае, если вам не нужно более 60 результатов, требуется минимальная задержка или вы хотите получить результаты в том же порядке, что и 2ГИС.

⬆️ OUTPUT

Результаты будут упакованы в набор данных, который вы найдете на вкладке Output и Storage. Обратите внимание, что для удобства просмотра выходные данные организованы в виде таблиц и вкладок. Вы можете просмотреть результаты в виде таблицы, JSON или карты.

После завершения обработки данных вы также можете загрузить набор данных в различных форматах (JSON, CSV, Excel, XML, HTML). Перед экспортом вы можете выбрать или исключить определенные поля вывода; кроме того, вы можете загрузить весь набор данных, включающий тематически связанные данные.

📊 Таблицы

Табличный вид можно настраивать различными способами. Доступен общий обзор, но также можно сортировать таблицу по контактной информации, рейтингу местоположения, отзывам или другим полям.

🧾 JSON-файл

Вот объем данных, который вы получите от одного места. Пример одного ресторана в Москве, данные с которого были скопированы:

{
  "id": "70000001031659781",
  "title": "Мясо&Рыба, ресторан",
  "shortName": "Мясо&рыба",
  "extension": "ресторан",
  "url": "https://2gis.ru/moscow/firm/70000001031659781",
  "rubrics": [
    "Рестораны",
    "Доставка еды"
  ],
  "category": "food_restaurant",
  "totalScore": 4.8,
  "reviewsCount": 1151,
  "ratingCount": 1474,
  "summary": "Красивый интерьер в стиле мясного и рыбного ресторанов с живыми аквариумами на столиках. Гости хвалят блюда из свежих продуктов, особенно стейк из лосося под живую музыку.",
  "postcode": "123001",
  "country": "Россия",
  "region": "Москва",
  "city": "Москва",
  "district": "Тверской",
  "street": "Тверская улица",
  "houseNumber": "23/12",
  "address": "Тверская улица, 23/12",
  "mainPhotoUrl": "https://i3.photo.2gis.com/main/branch/32/70000001031659781/common",
  "location": {
    "lat": 55.766672,
    "lng": 37.599969
  },
  "working_hours": {
    "Fri": {
      "from": "00:00",
      "to": "24:00"
    },
    "Mon": {
      "from": "00:00",
      "to": "24:00"
    },
    "Sat": {
      "from": "00:00",
      "to": "24:00"
    },
    "Sun": {
      "from": "00:00",
      "to": "24:00"
    },
    "Thu": {
      "from": "00:00",
      "to": "24:00"
    },
    "Tue": {
      "from": "00:00",
      "to": "24:00"
    },
    "Wed": {
      "from": "00:00",
      "to": "24:00"
    }
  },
  "nearestStations": [
    {
      "name": "Тверская",
      "distance": 320,
      "comment": "Замоскворецкая линия"
    },
    {
      "name": "Пушкинская",
      "distance": 350,
      "comment": "Таганско-Краснопресненская линия"
    },
    {
      "name": "Маяковская",
      "distance": 450,
      "comment": "Замоскворецкая линия"
    }
  ],
  "attributeGroups": [
    "Чек 2900 ₽",
    "Ланч от 680 ₽",
    "Рыбные заведения",
    "Европейская кухня",
    "Рыбная кухня",
    "Бизнес-ланч",
    "Завтрак",
    "Заказ столиков",
    "Заказ навынос",
    "Винная карта",
    "Меню на английском",
    "Постное меню",
    "Живая музыка",
    "VIP-зал",
    "Детский уголок",
    "Проведение банкетов",
    "Можно с ноутбуком",
    "Английский завтрак",
    "Ланч 12:00-16:00",
    "До 100 мест",
    "Пицца",
    "Шашлык",
    "Бургеры",
    "Пельмени",
    "Паста",
    "Стейки",
    "Том-Ям",
    "Люля-кебаб",
    "Картофель-фри",
    "Салаты",
    "Супы",
    "На гриле",
    "Фиш энд чипс",
    "Колбаски",
    "Мидии",
    "Устрицы",
    "Крабы",
    "Морские ежи",
    "Морские гребешки",
    "Кофе с собой",
    "Глинтвейн",
    "Чай с собой",
    "Шашлык",
    "Бургеры",
    "Завтраки",
    "Десерты",
    "Бизнес-ланч",
    "Паста",
    "Вторые блюда",
    "Корпоративные обеды",
    "Салаты",
    "Супы",
    "Том-Ям",
    "Стейки",
    "Рёбрышки",
    "Доставка",
    "Wi-Fi для клиентов",
    "Оплата картой",
    "Наличный расчёт",
    "Оплата через банк",
    "Оплата по QR-коду"
  ],
  "brand": {
    "name": "Мясо&Рыба, ресторан",
    "shortName": "Мясо&Рыба",
    "extension": "ресторан",
    "branchCount": 10,
    "rating": {
      "score": 4.8,
      "reviews": 3860
    }
  },
  "detailsType": "branch",
  "searchString": "Ресторан",
  "searchUrl": "https://2gis.ru/search/%D0%A0%D0%B5%D1%81%D1%82%D0%BE%D1%80%D0%B0%D0%BD?m=37.385264%2C55.581699%2F9",
  "pageNumber": 1,
  "scrapedAt": "2025-12-22T14:10:25.303Z"
}

☎️ Добавление контактной информации компании

{
  "phoneText": [
    "+7 (495) 609‒09‒08"
  ],
  "phoneValue": [
    "+74956090908"
  ],
  "email": [
    "fb@meat-and-fish.ru"
  ],
  "website": [
    "http://meat-and-fish.ru"
  ],
  "socials": {
    "vk": [
      "https://vk.com/meat_and_fish"
    ],
    "telegram": [
      "https://t.me/meat_and_fish_moscow"
    ],
    "whatsapp": [
      "https://wa.me/74956090908"
    ]
  }
}

⚠️ Важно: Добавление контактов — платная опция. Для этого актор заходит на страницу каждой организации, что замедляет работу и увеличивает стоимость. По умолчанию опция отключена.

🗺️ Фильтры и сортировка результатов

2GIS Places Scraper поддерживает расширенные фильтры и сортировку, которые полностью повторяют логику интерфейса 2ГИС. Это позволяет получать более релевантные и “чистые” выборки без постобработки данных.

🔎 Фильтры

Вы можете отфильтровать места по ключевым бизнес-и пользовательским признакам:

С ценами, Доставка, Заказ навынос, С сайтом, С фото, Оплата картой, Wi-Fi, Новые места в городе, Средний чек (от / до), Рейтинг

🔃 Сортировка

Результаты можно отсортировать так же, как в самом 2ГИС:

По рейтингу — сначала лучшие по оценкам По новизне — недавно открытые или добавленные места По алфавиту — удобно для каталогов и справочников Без сортировки — в оригинальном порядке 2ГИС

Сортировка влияет не только на порядок выдачи, но и на то, какие места будут извлечены первыми, что особенно важно при ограничении maxItems.

🗄Использование постоянного хранилища

По умолчанию каждый запуск актора создаёт временное хранилище Default.

Функция "enableGlobalDataset" позволяет накапливать результаты в постоянных хранилищах: - key_value_stores\2gis-dedupe-global **- datasets\2gis-global **

При включённой опции актор проверяет каждый найденный объект по id и добавляет в глобальный датасет только новые места, избегая дублей между запусками.

⚠️ Данная функция может быть очень полезна в сочетании с сортировкой По новизне для мониторинга новых организаций.

🗺️ Просмотр карты

Результаты отображаются на интерактивной карте:

• во вкладке Live View
• в файле results-map.html в Key-Value Store.

📡 Ввод местоположения и пользовательской области для точного поиска.

🧭 Местоположение

Обычно для начала сбора данных достаточно использовать свободный текст в поле «Местоположение».

2GIS Places Scraper использует OpenStreetMap в качестве API для определения местоположения. Вы можете легко проверить местоположение, соответствующее введенным вами данным на сайте. Официальная страница Open Street Map.

🛰 Выбор домена 2ГИС

Домены в 2ГИС - это отдельные базы данных на конкретную страну. Доступные значения: Россия (2gis.ru) Армения (2gis.am) Казахстан (2gis.kz) Киргизия (2gis.kg) ОАЭ (2gis.ae) Узбекистан (2gis.uz) Беларусь (2gis.by) Азербайджан (2gis.az) Грузия (2gis.ge) Таджикистан (2gis.tj) По умолчанию поле Домен 2ГИС имеет значение Россия (2gis.ru). ⚠️ Обязательно выбирайте нужный домен, если выполняете поиск в другой стране.

🛰 Пользовательская область поиска

Если ваше местоположение не найдено или вы хотите настроить поиск по определенной области, вы можете использовать функцию «Пользовательская область поиска».

В 2GIS Places Scraper можно использовать несколько типов геометрических областей поиска: Polygon, MultiPolygon и Point (по умолчанию это круг радиусом 5 километров). Обратите внимание, что в GeoJson первое поле должно содержать долготу, второе — широту.

Рекомендуем использовать Geojson.io и с лёгкостью создавать объекты любого типа/формы в правильном формате.

💠 Polygon

Наиболее распространенный тип — это полигон, представляющий собой набор точек, определяющих область сканирования. Обратите внимание, что первая и последняя пары координат должны совпадать (для замыкания полигона). Этот пример охватывает большую часть города Москва:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {},
      "geometry": {
        "coordinates": [
          [
            [
              37.53709323993428,
              55.76662127653114
            ],
            [
              37.55076839820586,
              55.71536538587122
            ],
            [
              37.67750542499144,
              55.71235159263938
            ],
            [
              37.69342377991097,
              55.76960954827027
            ],
            [
              37.610709021226626,
              55.80031206455419
            ],
            [
              37.53709323993428,
              55.76662127653114
            ]
          ]
        ],
        "type": "Polygon"
      }
    }
  ]
}

💠 MultiPolygon

Функция MultiPolygon позволяет объединять несколько несмежных многоугольников (например, остров, расположенный близко к материку). Как и в случае с обычным многоугольником, убедитесь, что первая и последняя пары координат в каждом многоугольнике совпадают.

{
    "type": "MultiPolygon",
    "coordinates": [
        [
            // first polygon
            [
                [
                    12.0905752, // Longitude
                    50.2524063 // Latitude
                ],
                [12.1269337, 50.2324336]
                // ...
            ]
        ],
        [
            // second polygon
            // ...
        ]
    ]
}

🔘 Круг

Для круга можно использовать Point тип с параметром radiusKm. Не забудьте изменить радиус в соответствии с вашими потребностями:

{
    "type": "Point",
    "coordinates": ["37.62141", "55.75227"],
    "radiusKm": 8
}

⭐ Ваш отзыв

Мы постоянно работаем над улучшением производительности наших акторов. Поэтому, если у вас есть какие-либо технические замечания по поводу 2GIS Places Scraper или вы просто обнаружили ошибку, пожалуйста, создайте заявку в разделе Issues.