{ "openapi": "3.0.1", "info": { "title": "📍 Google Maps Scraper: Business Leads, Emails & Reviews", "description": "Extract business data from Google Maps with just a few clicks. Get business names, emails, phone numbers, addresses, reviews, ratings, social profiles, and hours. Export unlimited leads to CSV, Excel, or JSON for cold outreach, lead generation, and market research with no coding.", "version": "0.1", "x-build-id": "hMmskCFj4LiOIXfRJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ha55an_dev~google-maps-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ha55an_dev-google-maps-leads-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/ha55an_dev~google-maps-leads-scraper/runs": { "post": { "operationId": "runs-sync-ha55an_dev-google-maps-leads-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/ha55an_dev~google-maps-leads-scraper/run-sync": { "post": { "operationId": "run-sync-ha55an_dev-google-maps-leads-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": [ "searchTerms", "locations" ], "properties": { "searchTerms": { "title": "Search Terms / Keywords", "type": "array", "description": "Keywords, business categories, or company names to search (e.g. ['Dentist', 'Italian Restaurant', 'Real Estate']).", "items": { "type": "string" } }, "locations": { "title": "Locations (Cities, States, Zipcodes)", "type": "array", "description": "Target locations to search. The actor geocodes and tiles each region automatically.", "items": { "type": "string" } }, "maxPlacesPerLocation": { "title": "Max Places per Location", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of places to collect per search term and location.", "default": 100 }, "enableAutoTiling": { "title": "Recursive Spatial Tiling (Bypass 120 Cap)", "type": "boolean", "description": "Automatically subdivides dense geographical regions into micro-quadrants to extract beyond Google's 120-place limit.", "default": true }, "extractEmails": { "title": "Extract Verified Emails & Socials", "type": "boolean", "description": "Visits each place's website to extract contact emails, Instagram, Facebook, LinkedIn, Twitter, TikTok, and YouTube.", "default": true }, "maxReviewsPerPlace": { "title": "Max Reviews per Place", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Number of detailed customer reviews to extract per place (0 = skip reviews for fastest speed).", "default": 0 }, "language": { "title": "Language Code", "type": "string", "description": "Google Maps interface language (e.g. en, es, fr, de, it).", "default": "en" }, "country": { "title": "Country Code", "type": "string", "description": "Country code for search relevance (e.g. us, uk, ca, au, de).", "default": "us" } } }, "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 } } } } } } } } } }