{ "openapi": "3.0.1", "info": { "title": "Google Maps Email Extractor & Lead Finder", "description": "Google Maps Lead Finder scrapes Google Maps business listings by keyword and location, then returns structured lead data with emails, phone numbers, ratings, reviews, and lead scores. It enriches each business by visiting their website to extract contact emails and social media links —...", "version": "0.1", "x-build-id": "nPI7l1bwh8j7LjM5O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~google-maps-lead-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-google-maps-lead-finder", "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/automation-lab~google-maps-lead-finder/runs": { "post": { "operationId": "runs-sync-automation-lab-google-maps-lead-finder", "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/automation-lab~google-maps-lead-finder/run-sync": { "post": { "operationId": "run-sync-automation-lab-google-maps-lead-finder", "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": "Business keywords to search on Google Maps (e.g., \"plumber\", \"dentist Berlin\"). Each query becomes a separate Maps search.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Optional city or region names (e.g., \"Chicago, IL\", \"Berlin, Germany\"). When set, each query is combined with each location for comprehensive geographic coverage.", "default": [], "items": { "type": "string" } }, "maxLeads": { "title": "Max leads", "minimum": 1, "type": "integer", "description": "Maximum number of unique leads to return. Lower values reduce cost and run time. Each lead triggers a pay-per-event charge.", "default": 100 }, "language": { "title": "Language", "enum": [ "en", "de", "es", "fr", "it", "pt", "nl", "pl", "ru", "ja", "ko", "zh", "ar", "tr" ], "type": "string", "description": "Language for Google Maps results. Controls the language of returned business names, categories, and addresses.", "default": "en" }, "countryCode": { "title": "Country code", "enum": [ "US", "GB", "DE", "FR", "ES", "IT", "PT", "NL", "PL", "AU", "CA", "BR", "MX", "JP", "KR", "IN", "RU", "TR", "AE" ], "type": "string", "description": "Country targeting for Google search (gl parameter). Helps return results relevant to the selected country.", "default": "US" }, "includeWebsiteEnrichment": { "title": "Include website enrichment", "type": "boolean", "description": "Visit each business website to extract emails and social media links. Disable to speed up runs when you only need basic listing data.", "default": true }, "enrichmentTimeoutSecs": { "title": "Enrichment timeout (secs)", "minimum": 5, "maximum": 45, "type": "integer", "description": "Timeout in seconds when fetching business websites. Increase for slow-loading sites in some regions, decrease for faster runs.", "default": 15 }, "dedupeStrategy": { "title": "Dedupe strategy", "enum": [ "placeId", "placeIdAndAddress" ], "type": "string", "description": "How to identify duplicate businesses across query/location combinations.", "default": "placeIdAndAddress" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration. Uses residential proxies by default for reliable Google Maps access." }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Enable verbose logging for troubleshooting. Shows detailed parser diagnostics in the run log.", "default": false } } }, "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 } } } } } } } } } }