{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper — Extract Business Data at Scale", "description": "Scrape Google Maps for business leads — extract name, address, phone, website, rating, reviews, hours, category, and coordinates. Residential proxies included. Pay per result. Export to CSV, JSON, or Excel.", "version": "1.0", "x-build-id": "uftrf0OjNA7w6CEKk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fascinating_lentil~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fascinating_lentil-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/fascinating_lentil~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-fascinating_lentil-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/fascinating_lentil~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-fascinating_lentil-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": [ "keywords" ], "properties": { "keywords": { "title": "Search keywords", "minItems": 1, "type": "array", "description": "One or more business types or search terms. Each keyword is combined with each location worldwide.", "items": { "type": "string" } }, "locations": { "title": "Custom worldwide locations", "minItems": 1, "type": "array", "description": "Optional custom cities, regions, postal codes, addresses, or 'lat,lon' pairs. Include the country for best accuracy, e.g. 'Paris, France' or 'Tokyo, Japan'. You can also use a preset below.", "items": { "type": "string" } }, "locationPreset": { "title": "Location preset", "enum": [ "none", "high_demand_markets", "world_major_cities" ], "type": "string", "description": "Optional city preset. Choose 'High-demand commercial markets' for the strongest lead-generation geographies, or 'World major cities' for broad global coverage. Custom locations are added on top.", "default": "none" }, "maxResults": { "title": "Max results per query", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of businesses to save per keyword/location combination. Start small for tests; increase to 100-5000 for production runs.", "default": 10 }, "language": { "title": "Result language", "pattern": "^[a-zA-Z]{2,5}$", "minLength": 2, "maxLength": 5, "type": "string", "description": "Two-letter language code for result text, e.g. 'en', 'es', 'de', 'fr', 'ja'.", "default": "en" }, "countryCode": { "title": "Optional country bias", "pattern": "^[a-zA-Z]{2}$", "minLength": 2, "maxLength": 2, "type": "string", "description": "Optional two-letter country code that biases Google Maps results and proxy country, e.g. 'us', 'gb', 'de', 'jp'. Leave empty for worldwide searches based only on the location text." }, "maxCrawledPlacesPerQuery": { "title": "Max places to visit per query", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on detail pages the Actor opens per keyword/location. Set higher than maxResults when many listings may be duplicates, closed, or missing details.", "default": 20 }, "skipClosedBusinesses": { "title": "Skip permanently closed businesses", "type": "boolean", "description": "If true, businesses marked as 'Permanently closed' are filtered out.", "default": true }, "scrapeDetails": { "title": "Visit each place page for phone + full address", "type": "boolean", "description": "If true, when the list view does not include a phone number or full address, the Actor visits the place's individual page to retrieve them along with the plus code. Disable for faster runs when phone and full address are not required.", "default": true }, "proxyConfig": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration. Residential is strongly recommended for Google Maps. Leave proxy country empty for global runs, or set it to match the target country.", "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 } } } } } } } } } }