Pricing
from $2.00 / 1,000 results
Извлекайте данные из тысяч мест и предприятий на 2ГИС. Экспортируйте данные, запускайте через API, планируйте и отслеживайте запуски или интегрируйте с другими инструментами.
You can access the 2gis Places Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "1.0", "x-build-id": "ku8nsV7FkQDKIe7XQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/m_mamaev~2gis-places-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-m_mamaev-2gis-places-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/m_mamaev~2gis-places-scraper/runs": { "post": { "operationId": "runs-sync-m_mamaev-2gis-places-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/m_mamaev~2gis-places-scraper/run-sync": { "post": { "operationId": "run-sync-m_mamaev-2gis-places-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", "required": [ "query" ], "properties": { "query": { "title": "Поисковая строка", "type": "array", "description": "Введите в поисковую строку то, что вы обычно ищете на 2GIS. Например, `барбершоп` или `ресторан`. Старайтесь использовать разные по смыслу запросы. Использование похожих терминов [ресторан, бар, кафе] может немного повысить вероятность получения результатов, но снижает эффективность. \n\n ⚠️Внимание: Если добавить локацию в поисковую строку, а не в поле Местоположение, то вы можете столкнуться сограничением 2ГИС и получить не больше 60 результатов.", "default": [ "Ресторан" ], "items": { "type": "string" } }, "locationQuery": { "title": "Местоположение", "type": "string", "description": "Укажите местоположение в виде свободного текста, наример: Москва, Россия. Для визуальной проверки области поиска используйте [веб-приложение OpenStreetMap](https://nominatim.openstreetmap.org/ui/search.html). \n\n Для более точной настройки области поиска перейдите в раздел «Пользовательская область поиска», чтобы создать полигональные фигуры областей, которые вы хотите обработать. Обратите внимание, что «Пользовательская область поиска» имеет приоритет над полем «Местоположение» (поэтому используйте любой из разделов, но не оба одновременно). \n\n ⚠️ Если область поиска находится за пределами России, необходимо изменить домен в поле «Домен 2ГИС» на домен соответствующей страны.", "default": "" }, "domain": { "title": "Страна, домен 2ГИС", "enum": [ "2gis.ru", "2gis.am", "2gis.kz", "2gis.kg", "2gis.ae", "2gis.uz", "2gis.by", "2gis.az", "2gis.ge", "2gis.tj" ], "type": "string", "description": "Выберите домен 2ГИС в зависимости от целевой страны.", "default": "2gis.ru" }, "maxItems": { "title": "Количество мест для извлечения данных (на каждый поисковый запрос)", "minimum": 0, "type": "integer", "description": "Количество результатов, которые вы ожидаете получить по каждому поисковому запросу. Чем больше число, тем дольше будет работать процесс. \n\n Если вы хотите собрать данные по всем доступным местам, введите 0 (без лимита).", "default": 50 }, "includeContacts": { "title": "Добавить Контакты ($)", "type": "boolean", "description": "Обогащает информацию о местах на 2GIS контактными данными. ", "default": false }, "filterHasGoods": { "title": "С ценами", "type": "boolean", "description": "Показывать места с ценами (sorting_has_goods).", "default": false }, "filterHomeDelivery": { "title": "Доставка", "type": "boolean", "description": "Фильтр доставки (covid_homedelivery).", "default": false }, "filterTakeaway": { "title": "Заказ навынос", "type": "boolean", "description": "Фильтр навынос (food_service_details_food_takeaway).", "default": false }, "filterHasSite": { "title": "С сайтом", "type": "boolean", "description": "Показывать места с сайтом (has_site).", "default": false }, "filterHasPhotos": { "title": "С фото", "type": "boolean", "description": "Показывать места с фото (has_photos).", "default": false }, "filterPaymentCard": { "title": "Расчет по картам", "type": "boolean", "description": "Показывать места с оплатой картой (general_payment_type_card).", "default": false }, "filterAvgPriceMin": { "title": "Средний чек от", "minimum": 0, "type": "integer", "description": "Минимальный средний чек (food_service_avg_price)." }, "filterAvgPriceMax": { "title": "Средний чек до", "minimum": 0, "type": "integer", "description": "Максимальный средний чек (food_service_avg_price)." }, "filterCreatedRecently": { "title": "Новые места в городе", "type": "boolean", "description": "Показывать новые места (created_recently).", "default": false }, "filterWifi": { "title": "Wi-Fi", "type": "boolean", "description": "Показывать места с Wi-Fi (additionally_services_wifi).", "default": false }, "filterRating": { "title": "Рейтинг", "enum": [ "", "rating_rating_perfect", "rating_rating_excellent", "rating_rating_pretty_good", "rating_rating_nice", "rating_rating_not_bad" ], "type": "string", "description": "Выберите только один фильтр рейтинга.", "default": "" }, "sortBy": { "title": "Сортировка", "enum": [ "", "rating", "opened_time", "name" ], "type": "string", "description": "Выберите вариант сортировки.", "default": "" }, "customGeolocation": { "title": "Пользовательская область поиска (GeoJSON)", "type": "object", "description": "Имеет приоритет над locationQuery." }, "enableGlobalDataset": { "title": "Использовать глобальный датасет (включая дедупликацию)", "type": "boolean", "description": "Включите, если хотите накапливать результаты из нескольких запусков.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Настройки прокси для обхода блокировок", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for 2gis Places Scraper from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: