{ "openapi": "3.0.1", "info": { "title": "Google Maps Email Extractor - Google Maps Business Leads", "description": "Google Maps leads with business emails: local businesses on Google Maps (Google Places, GMB), each one's email from its own website, MX-checked - a business owner email finder for local leads. Reads Google Maps itself: $3 per 1,000 places with an email, $1 per 1,000 without.", "version": "0.2", "x-build-id": "84sANb9WPMPjfvc2F" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sandy_yclept~google-maps-email-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sandy_yclept-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/sandy_yclept~google-maps-email-extractor/runs": { "post": { "operationId": "runs-sync-sandy_yclept-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/sandy_yclept~google-maps-email-extractor/run-sync": { "post": { "operationId": "run-sync-sandy_yclept-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", "properties": { "searchStringsArray": { "title": "Search terms", "type": "array", "description": "What you would type into Google Maps, one term per line: \"dentist\", \"plumber\", \"Steuerberater\". Every term is searched in the location below. By default this Actor reads Google Maps itself: a place costs $0.003 with an email and, from October 27, 2026, $0.001 without one; the other sources under \"Where the places come from\" bill their places to your account in a separate run.", "items": { "type": "string" } }, "locationQuery": { "title": "Location", "type": "string", "description": "Where to search, as free text: a city and country work best (\"Chicago, USA\", \"Köln, Deutschland\"). One location per run. Leave it empty when the search terms already say where." }, "maxCrawledPlacesPerSearch": { "title": "Places per search term", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many Google Maps places to take for each search term. Every place found is paid for - $0.003 with an email, $0.001 without (from October 27, 2026) - so this caps what a run costs; scraperlink and compass bill every place they return themselves (scraperlink at least 10 per term). Reading the websites takes about 3 seconds per place; the run stops taking new places shortly before its timeout and says how many were left.", "default": 20 }, "language": { "title": "Language", "enum": [ "en", "af", "az", "id", "ms", "bs", "ca", "cs", "da", "de", "et", "es", "es-419", "eu", "fil", "fr", "gl", "hr", "zu", "is", "it", "sw", "lv", "lt", "hu", "nl", "no", "uz", "pl", "pt-BR", "pt-PT", "ro", "sq", "sk", "sl", "fi", "sv", "vi", "tr", "el", "bg", "ky", "kk", "mk", "mn", "ru", "sr", "uk", "ka", "hy", "iw", "ur", "ar", "fa", "am", "ne", "hi", "mr", "bn", "pa", "gu", "ta", "te", "kn", "ml", "si", "th", "lo", "my", "km", "ko", "ja", "zh-CN", "zh-TW" ], "type": "string", "description": "Language of the place names, categories and addresses Google Maps returns. Emails and websites are the same in any language.", "default": "en" }, "placeSource": { "title": "Where the places come from", "enum": [ "google", "scraperlink", "compass" ], "type": "string", "description": "This Actor itself (default) reads Google Maps' search results: no other Actor, with phone, website, hours and coordinates; $0.001 a place without an email from October 27, 2026. Should Google refuse, scraperlink takes over at its price. scraperlink/google-maps-scraper, on your account: $0.50 per 1,000 places on Free and Starter ($0.40 above), at least 10 per term; compass takes over when it finds nothing. compass/crawler-google-places: $4 per 1,000 on Free, closest to Google Maps' ranking.", "default": "google" }, "mapsDatasetId": { "title": "Or: places you already have (Google Maps dataset)", "type": "string", "description": "A dataset from an earlier Google Maps scrape - Google Maps Scraper's, or any export with a website per place. Its places are enriched instead of a new search, nothing is paid for finding them again, and only a place with an email is charged. Given together with search terms, both are read and duplicates are merged." }, "maxContactPages": { "title": "Max contact subpages", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many contact-like subpages (/contact, /about, /impressum, the privacy policy) to read on each place's website, on top of the page Google Maps links to. Set to 0 to read that page only.", "default": 5 }, "validateEmails": { "title": "Validate emails (MX + scoring)", "type": "boolean", "description": "Check each email's domain for MX records and attach a confidence score. An address whose domain accepts no mail is returned but never billed as an email. Turn off for a faster run without the check.", "default": true }, "includeSocials": { "title": "Extract social profiles", "type": "boolean", "description": "Extract LinkedIn, X/Twitter, Facebook, Instagram, YouTube and TikTok profile links from each website (share/intent URLs are filtered out). Included in the price of a place; socials alone never make a place a Business email.", "default": true }, "renderJs": { "title": "JavaScript rendering", "enum": [ "off", "auto", "on" ], "type": "string", "description": "Load pages in a real browser to reach contacts that are rendered by JavaScript. Off (default) is the fastest and cheapest. Auto reads a website without a browser first and only re-reads it in the browser when no email the place could be billed for was found - the phone Google Maps already shows does not count. On always uses the browser. Auto and On require the run memory to be at least 2048 MB. Below 1024 MB the browser is not started and the run says so.", "default": "off" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy for fetching pages. Apify Proxy's datacenter IPs are included in every Apify plan, the Free plan too; residential proxies are billed separately. Left disabled, the Actor connects directly, and retries sites that refuse it through Apify Proxy (see below).", "default": { "useApifyProxy": false } }, "proxyFallback": { "title": "Retry refused sites through Apify Proxy", "type": "boolean", "description": "Every cloud run has a datacenter IP address, and some sites turn those away. A site that refuses or drops the direct connection is retried once through Apify Proxy's datacenter IPs (included in every Apify plan, the Free plan too), then once more directly. Sites that answer directly never go through the proxy, and robots.txt is respected either way. Has no effect when a proxy is configured above.", "default": true } } }, "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 } } } } } } } } } }