{ "openapi": "3.0.1", "info": { "title": "Google Maps Email Extractor", "description": "Google Maps Email Extractor pulls publicly available business email addresses from Google Maps listings. Build targeted contact lists by location, category, or rating. Ideal for sales teams and local marketers.", "version": "0.6", "x-build-id": "o7e5aC6dY09vDqdRk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~google-maps-email-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-google-maps-email-extractor", "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/scraper-engine~google-maps-email-extractor/runs": { "post": { "operationId": "runs-sync-scraper-engine-google-maps-email-extractor", "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/scraper-engine~google-maps-email-extractor/run-sync": { "post": { "operationId": "run-sync-scraper-engine-google-maps-email-extractor", "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": [ "keywords" ], "properties": { "keywords": { "title": "๐Ÿ” Keywords", "type": "array", "description": "๐ŸŽฏ The words that power your search! Add one or more keywords (e.g. ['restaurant', 'plumber', 'dentist']). For each keyword the actor discovers real businesses of that type, opens their websites, and ๐Ÿ“ง extracts the email addresses published there. ๐Ÿ’ก Tip: more specific keywords = more targeted leads.", "items": { "type": "string" } }, "platform": { "title": "๐ŸŒ Platform", "enum": [ "Google-Maps" ], "type": "string", "description": "๐Ÿ—บ๏ธ The business universe to scrape. Currently locked to Google Maps style business listings โ€” more platforms coming soon! ๐Ÿš€", "default": "Google-Maps" }, "location": { "title": "๐Ÿ“ Location Filter", "type": "string", "description": "๐Ÿ—บ๏ธ City, region or country (e.g. 'London' ๐Ÿ‡ฌ๐Ÿ‡ง, 'Brighton, UK', 'Austin, Texas' ๐Ÿค ). โญ Strongly recommended: with a location the actor also queries the free map/POI database for that exact area, which yields real, addressed businesses instead of generic web pages. โœจ Leave empty to search worldwide with web search only.", "default": "" }, "emailDomains": { "title": "๐Ÿ“ง Email Domains Filter", "type": "array", "description": "๐ŸŽ›๏ธ Keep only emails from the domains you care about โ€” type as many as you like! โœ๏ธ Popular picks: ๐Ÿ“ฎ @gmail.com ยท ๐Ÿ“จ @outlook.com ยท ๐Ÿ’Œ @hotmail.com ยท ๐Ÿ’œ @yahoo.com ยท โ˜๏ธ @icloud.com ยท ๐Ÿ“ฌ @aol.com ยท ๐Ÿ”’ @protonmail.com ยท ๐Ÿ“ฅ @live.com ยท ๐Ÿ“ง @gmx.com ยท ๐ŸŸก @yandex.com ยท ๐Ÿ“— @zoho.com. ๐Ÿข Custom/business domains work too โ€” e.g. @yourcompany.com. ๐Ÿ•ณ๏ธ Leave empty to collect emails from ALL domains (recommended โ€” most businesses use their own domain). ๐Ÿ’ก Adding a domain also sharpens the search ๐ŸŽฏ.", "items": { "type": "string" } }, "maxEmails": { "title": "๐Ÿ“Š Maximum Emails per Keyword", "minimum": 1, "maximum": 100000, "type": "integer", "description": "๐ŸŽš๏ธ How many emails to collect per keyword before moving on. โšก Higher = more leads but longer runs. Default is 10 โœ… (range 1 โ€“ 100,000).", "default": 10 }, "engine": { "title": "โš™๏ธ Engine", "enum": [ "legacy" ], "type": "string", "description": "๐Ÿ”ง The processing engine. Currently 'legacy' ๐Ÿ›ก๏ธ โ€” a reliable, battle-tested extraction pipeline. More engines on the roadmap! ๐Ÿšง", "default": "legacy" }, "maxSitesPerKeyword": { "title": "๐Ÿ—‚๏ธ Maximum Websites to Open per Keyword", "minimum": 5, "maximum": 1000, "type": "integer", "description": "๐Ÿ”Ž How many business websites the actor may open while hunting for emails for one keyword. Raise it when a strict email-domain filter makes matches rare; lower it to finish faster. Default 80.", "default": 80 }, "googlePlacesApiKey": { "title": "๐Ÿ”‘ Google Places API Key (optional)", "type": "string", "description": "๐Ÿ—๏ธ Entirely optional. If you have your own Google Places API key, paste it here and the actor will also pull businesses straight from Google's Places Text Search before falling back to the free sources. ๐Ÿ†“ Leave empty โ€” the actor works fully without a key, using the free map/POI database plus web search." }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy Configuration", "type": "object", "description": "๐ŸŒ Control how the actor connects to search engines. ๐Ÿ†“ Leave it empty and the actor auto-selects Apify Residential proxies, which are needed to query search engines reliably. ๐Ÿ”„ On any failed response it rotates the connection and retries automatically. ๐Ÿง  Advanced users can plug in custom proxies here.", "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 } } } } } } } } } }