{ "openapi": "3.0.1", "info": { "title": "Google Maps Lead Enrichment - Emails, Phones, Socials", "description": "Turn Google Maps searches into sales-ready lead lists with business names, addresses, ratings, websites, public emails, phone numbers, social profiles, contact pages, and optional email-domain validation. You can also enrich existing website or business lists.", "version": "0.1", "x-build-id": "y8dSucnvizOUSUBYH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thirdwatch~google-maps-lead-enrichment/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thirdwatch-google-maps-lead-enrichment", "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/thirdwatch~google-maps-lead-enrichment/runs": { "post": { "operationId": "runs-sync-thirdwatch-google-maps-lead-enrichment", "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/thirdwatch~google-maps-lead-enrichment/run-sync": { "post": { "operationId": "run-sync-thirdwatch-google-maps-lead-enrichment", "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": { "queries": { "title": "Google Maps search queries", "type": "array", "description": "Local-business searches, exactly as you would type them into Google Maps. Include the location in the text, e.g. \"plumbers in Austin TX\" or \"yoga studios Melbourne AU\". Each query returns up to about 120 businesses.", "default": [], "items": { "type": "string" } }, "websites": { "title": "Websites to enrich directly", "type": "array", "description": "Optional. Skip the Google Maps step and enrich these website URLs directly. Can be combined with queries.", "default": [], "items": { "type": "string" } }, "businesses": { "title": "Business objects to enrich", "type": "array", "description": "Optional. Business records (objects with a website field, e.g. the output of a Google Maps place scraper). Their fields are carried through onto the enriched rows.", "default": [] }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of enriched business rows to produce across all queries.", "default": 10 }, "maxPagesPerSite": { "title": "Pages per website", "minimum": 1, "maximum": 4, "type": "integer", "description": "How many pages to read per business site: the homepage plus the highest-ranked contact/about/impressum pages. Yield saturates at 4 - deeper crawls cost far more bandwidth for almost no extra contacts.", "default": 4 }, "concurrency": { "title": "Concurrent websites", "minimum": 1, "maximum": 32, "type": "integer", "description": "How many business websites to fetch in parallel. Every target is a different host, so there is no shared rate limit. 8 is safe at the default memory; raise memory to 512 MB before going above 16.", "default": 8 }, "verifyEmailDomains": { "title": "Validate email domains (DNS MX)", "type": "boolean", "description": "Look up the MX records of the primary email's domain to confirm it can receive mail. This filters out theme placeholders and dead domains. It does not verify the individual mailbox.", "default": true }, "onlyWithContact": { "title": "Only output leads with a contact channel", "type": "boolean", "description": "Skip businesses where no email, phone or social profile was found anywhere. Reduces the number of billed rows.", "default": false }, "retryBlockedWithProxy": { "title": "Retry blocked websites", "type": "boolean", "description": "Retry websites that restrict the first visit. This can improve coverage but may make the run slower; leave it off unless you need maximum reachability.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional connection settings used only when retrying restricted websites.", "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 } } } } } } } } } }