{ "openapi": "3.0.1", "info": { "title": "Google Maps Email Extractor", "description": "Find local businesses on Google Maps and get business emails from each one's own website: Google Maps leads with an MX-checked email, phone and socials. This Actor charges only for places where an email is found; the search is billed per place by the Google Maps scraper it runs, $0.50 per 1,000.", "version": "0.2", "x-build-id": "HjIXYjLR9nYrfRdKE" }, "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. The places are found by a Google Maps scraper that bills its own places to your account in a separate run - see \"Where the places come from\" and the README for prices.", "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. The Google Maps search bills every place it returns - at least 10 per term with the default source - so this also caps what the search costs. 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": [ "scraperlink", "compass" ], "type": "string", "description": "Which Google Maps scraper finds the places, in a run of its own on your account. scraperlink/google-maps-scraper: $0.50 per 1,000 places on the Free and Starter plans ($0.40 on higher ones), at least 10 per search term; when it finds nothing, compass/crawler-google-places takes over. compass/crawler-google-places: $4 per 1,000 places on the Free plan, closest to Google Maps' own ranking. The emails are read the same way from either.", "default": "scraperlink" }, "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, and nothing is paid for finding them again. 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. 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; a place with only socials is not billed.", "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 } } } } } } } } } }