{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper + Email Extractor", "description": "Scrapes Google Maps business listings — name, address, coordinates, rating, review count, phone, website, categories and opening status — with real pagination. Optionally visits each business website to extract contact emails. HTTP only, no API key.", "version": "0.1", "x-build-id": "admNJmcHj0IOu8QSc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-google-maps-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/scrapyx~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-google-maps-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/scrapyx~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-google-maps-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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "What to search for on Google Maps, one per line — e.g. 'coffee shops in Jakarta' or 'dentist'. Each query is paginated independently.", "items": { "type": "string" } }, "latitude": { "title": "Search centre latitude", "type": "number", "description": "Latitude of the point to search around. This is a REAL filter, not a hint — the same query at a different centre returns a different neighbourhood's businesses, so set it to the city you actually want.", "default": -6.2 }, "longitude": { "title": "Search centre longitude", "type": "number", "description": "Longitude of the point to search around. Pair it with the latitude above; leaving the default while changing the query is the most common way to get confusing results.", "default": 106.8 }, "searchRadiusHint": { "title": "Search area size", "minimum": 100, "maximum": 2000000, "type": "integer", "description": "Viewport span Google is asked to cover. Larger values search a wider area around the centre; smaller values concentrate on the immediate neighbourhood.", "default": 10000 }, "maxPlacesPerQuery": { "title": "Max places per query", "minimum": 0, "type": "integer", "description": "Stop after this many places per query. 0 = keep paging until Google runs out (it thins out well before the 400-place ceiling).", "default": 60 }, "language": { "title": "Language", "type": "string", "description": "Google UI language code (hl), e.g. en, id, de. Affects category names and opening-hours wording.", "default": "en" }, "countryCode": { "title": "Country", "type": "string", "description": "Google country code (gl), e.g. us, id, de. Affects ranking and phone formatting.", "default": "us" }, "extractEmails": { "title": "Extract contact emails", "type": "boolean", "description": "For every place that lists a website, fetch that site and pull contact email addresses from it. This costs extra requests to third-party sites (not to Google), so it makes runs slower — leave it off if you only need the Maps listing.", "default": false }, "emailMaxPagesPerSite": { "title": "Max pages per website", "minimum": 1, "maximum": 9, "type": "integer", "description": "How many pages to try per business site before giving up — homepage first, then /contact, /about and friends. Stops early as soon as an address is found.", "default": 4 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel website fetches during email extraction. Maps pages are always fetched one at a time because Google rate-limits that endpoint.", "default": 4 }, "minRequestInterval": { "title": "Min delay between requests", "minimum": 0, "maximum": 10, "type": "number", "description": "Minimum gap between request starts, in seconds. Paces starts without holding a worker. Raise it if you hit Google's rate wall.", "default": 0.5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy on the shared datacenter pool. This is the default because it is included in your plan at no extra cost and the Maps endpoint works through it. If Google starts showing its rate wall, switch the group here to Residential — it uses real consumer IPs, but Apify bills residential traffic per gigabyte.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }