{ "openapi": "3.0.1", "info": { "title": "Local Google Maps Lead Scraper", "description": "The Local Google Maps Lead Scraper extracts business listings from Google Maps and enriches each lead with emails, social links, contact pages, detected tech stack, lead score, and an optional AI-generated pitch angle — ideal for local SEO, web design, reputation management, and SMB lead generation.", "version": "0.0", "x-build-id": "FreC6wz7qc9Zu7UIp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~local-google-maps-lead-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-local-google-maps-lead-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/piotrv1001~local-google-maps-lead-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-local-google-maps-lead-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/piotrv1001~local-google-maps-lead-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-local-google-maps-lead-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Google Maps search queries, e.g. \"dentists in Warsaw\". Each query is converted into a Google Maps search URL.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of Google Maps search URLs to start from. Use either searchQueries, startUrls, or both.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "language": { "title": "Language", "type": "string", "description": "Language/locale code passed to Google Maps (hl parameter).", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Optional country code passed to Google Maps (gl parameter).", "default": "" }, "maxPlacesPerSearch": { "title": "Max places per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of place URLs to extract per search query.", "default": 100 }, "maxRequestsPerCrawl": { "title": "Max requests per crawl", "minimum": 0, "type": "integer", "description": "Maximum total requests for the entire crawl. 0 = unlimited.", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of pages to scrape in parallel. Keep low (1-5) to avoid blocks.", "default": 3 }, "requestHandlerTimeoutSecs": { "title": "Request handler timeout (seconds)", "minimum": 30, "maximum": 600, "type": "integer", "description": "How long a single page handler may run before timing out.", "default": 120 }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Filter out businesses with average rating below this value (0 = disabled).", "default": 0 }, "minReviews": { "title": "Minimum number of reviews", "minimum": 0, "type": "integer", "description": "Filter out businesses with fewer reviews than this (0 = disabled).", "default": 0 }, "onlyWithWebsite": { "title": "Only businesses with a website", "type": "boolean", "description": "If true, drop leads that do not have a website on Google Maps.", "default": false }, "onlyWithPhone": { "title": "Only businesses with a phone number", "type": "boolean", "description": "If true, drop leads that do not have a phone number.", "default": false }, "includeClosedBusinesses": { "title": "Include permanently closed businesses", "type": "boolean", "description": "If false, permanently closed businesses are filtered out.", "default": false }, "includeTemporarilyClosed": { "title": "Include temporarily closed businesses", "type": "boolean", "description": "If false, temporarily closed businesses are filtered out.", "default": true }, "enrichWebsite": { "title": "Enrich website", "type": "boolean", "description": "Visit each business's website to extract emails, social links, contact page, title and meta description.", "default": true }, "aiEnrichment": { "title": "AI enrichment (billed separately)", "type": "boolean", "description": "Generate an AI-powered business summary, ICP fit, pitch angle, pain points and recommended offer for every lead. Billed as a separate event. Requires the actor maintainer to have configured an OpenAI API key.", "default": false }, "websiteEnrichmentTimeoutSecs": { "title": "Website enrichment timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-site timeout for website enrichment.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Residential proxy is recommended for Google Maps scraping.", "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 } } } } } } } } } }