{ "openapi": "3.0.1", "info": { "title": "Google Maps Lead Finder & Website Opportunity Scores", "description": "Find local businesses by niche and location and assess public website, review and contact signals. Export explainable opportunity scores for agency prospecting. Results depend on source access and available public data.", "version": "1.0", "x-build-id": "NoZiOe3QiVTEBNipg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/egeusta~google-maps-local-business-opportunity-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-egeusta-google-maps-local-business-opportunity-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/egeusta~google-maps-local-business-opportunity-finder/runs": { "post": { "operationId": "runs-sync-egeusta-google-maps-local-business-opportunity-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/egeusta~google-maps-local-business-opportunity-finder/run-sync": { "post": { "operationId": "run-sync-egeusta-google-maps-local-business-opportunity-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", "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Business categories or keywords to search on Google Maps, e.g. \"dentist\", \"coffee shop\".", "default": [ "dentist" ], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Locations to combine with each search query, e.g. \"Austin, TX\". Each query is run once per location.", "default": [ "Austin, TX" ], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Google Maps search URLs or direct place URLs. Place URLs are scraped directly without a feed selector.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper bound on places collected from a single search query/location or search URL.", "default": 20 }, "maxTotalResults": { "title": "Max total results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Global cap on the number of unique businesses emitted to the dataset.", "default": 100 }, "includeClosedBusinesses": { "title": "Include closed businesses", "type": "boolean", "description": "When disabled, permanently and temporarily closed businesses are filtered out (their status is still reported when included).", "default": false }, "language": { "title": "Language", "type": "string", "description": "Google Maps UI language hint (BCP-47 code such as \"en\", \"de\").", "default": "en" }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-request timeout for Google Maps and website fetches.", "default": 30 }, "enrichFromWebsite": { "title": "Enrich from business website", "type": "boolean", "description": "Fetch each business website (SSRF-guarded) to detect HTTPS, mobile readiness, and public contact details.", "default": true }, "maxWebsitePagesPerBusiness": { "title": "Max website pages per business", "minimum": 1, "maximum": 5, "type": "integer", "description": "Homepage plus this many same-origin secondary pages (e.g. contact, about).", "default": 2 }, "websiteConcurrency": { "title": "Website fetch concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of business websites fetched in parallel.", "default": 5 }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip website pages disallowed by the site's robots.txt for this crawler.", "default": true }, "maxWebsiteBytes": { "title": "Max website bytes per page", "minimum": 50000, "maximum": 10000000, "type": "integer", "description": "Hard ceiling on bytes read from a single website page.", "default": 1500000 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }