{ "openapi": "3.0.1", "info": { "title": "2GIS Places Scraper: Every Result, Contacts", "description": "2GIS places with phones, emails, sites, socials, hours and ratings, every result of a search. $2 per 1,000 places. Russia, Kazakhstan, UAE.", "version": "0.1", "x-build-id": "dxEyIEiJxDL1S5Zmm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/luzivanlt~2gis-places-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-luzivanlt-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/luzivanlt~2gis-places-scraper/runs": { "post": { "operationId": "runs-sync-luzivanlt-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/luzivanlt~2gis-places-scraper/run-sync": { "post": { "operationId": "run-sync-luzivanlt-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", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What to search 2GIS for, as you would type it on the map, e.g. кафе, dentist or car wash. Each term is searched in each city below and read to the last result 2GIS counts for it. Leave empty to use only categories or links.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "The 2GIS cities to search in, by name in any spelling or by the code in a 2GIS link: e.g. Moscow, Москва, spb, Almaty, Astana, Tashkent or Dubai. A 2GIS city is a region: Moscow includes its oblast's towns, and Dubai is 2GIS's region for the whole UAE (Abu Dhabi and Sharjah included). To narrow a search, add the town or district to the search term (cafe Khimki, restaurant Dubai Marina). Needed for search terms and categories.", "items": { "type": "string" } }, "categoryIds": { "title": "Category ids", "type": "array", "description": "2GIS category ids to read whole in each city, e.g. 161 for cafes or 164 for restaurants (the number after rubricId/ in a 2GIS category link). Each category × city is one search.", "items": { "type": "string" } }, "startUrls": { "title": "2GIS links", "type": "array", "description": "2GIS search pages (https://2gis.ru/moscow/search/кафе), category pages (https://2gis.ru/moscow/search/Кафе/rubricId/161) or place pages (https://2gis.kz/almaty/firm/70000001012345678), on any 2GIS site: 2gis.ru, 2gis.kz, 2gis.ae, 2gis.uz, 2gis.kg, 2gis.am, 2gis.az, … A link given twice is read once. Links with filters are not supported yet. Example: https://2gis.ae/dubai/search/restaurant", "items": { "type": "string" } }, "maxPlacesPerSearch": { "title": "Max places per search", "minimum": 1, "maximum": 50000, "type": "integer", "description": "The most places to save from each search, category or link. A search is read in 2GIS's own order until this many, or to the last result 2GIS counts. Default 100. You pay per place saved.", "default": 100 }, "language": { "title": "Language", "enum": [ "auto", "ru", "en", "kk", "uz", "ky", "az", "hy", "ka", "tg", "ar", "cs", "it", "es", "uk", "zh" ], "type": "string", "description": "The language of names, categories and addresses, where 2GIS has it for that city (English for Moscow and Dubai, Kazakh for Almaty, …). Auto uses 2GIS's default for each city: Russian where 2GIS has it (Russia, Kazakhstan, Uzbekistan, …), English in the UAE. e.g. en for English names in Moscow.", "default": "auto" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }