{ "openapi": "3.0.1", "info": { "title": "Google Maps Email Extractor & Scraper: Business Leads", "description": "Google Maps email extractor and lead scraper: business emails from websites, mail server (MX) checked, social profiles, contact page, phone, address. Pay only for places with an email: $1.49 per 1,000. Free lead filters, no repeat leads.", "version": "0.1", "x-build-id": "2vtYRSfb0GAQs8gMV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~google-maps-email-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-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/s_actors~google-maps-email-extractor/runs": { "post": { "operationId": "runs-sync-s_actors-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/s_actors~google-maps-email-extractor/run-sync": { "post": { "operationId": "run-sync-s_actors-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": { "searchTerms": { "title": "πŸ”Ž Search terms", "type": "array", "description": "What you would type into Google Maps, one per line: \"plumber\", \"dentist\", \"coffee shop\", \"roofing contractor\", \"italian restaurant\", \"car dealer\". Each term is searched in every location below. Without locations, write the place into the term: \"dentist in Austin TX\".", "items": { "type": "string" } }, "locations": { "title": "πŸ“ Locations", "type": "array", "description": "City, ZIP / postal code, region or country, one per line: \"Austin, TX\", \"10001\", \"London\", \"Bavaria, Germany\", \"SW1A 1AA\". The Actor finds the area on Google Maps and searches inside it. Several = each term in each location.", "items": { "type": "string" } }, "maxPlacesPerSearch": { "title": "πŸ’― Max leads per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Places WITH an email per search term and location (with \"Only places with an email\" on; otherwise places in total). The Actor keeps reading Google Maps until it has this many, up to 6 places per lead asked for. Places without an email are free.", "default": 50 }, "onlyWithEmail": { "title": "πŸ“§ Only places with an email", "type": "boolean", "description": "On: only places whose website shows an email (you pay only for these). Off: also places without an email, free, with their phone, social profiles and contact page.", "default": true }, "checkEmailDomains": { "title": "βœ… Check email domains (MX)", "type": "boolean", "description": "Look up each email domain for a mail server (DNS MX records). Emails whose domain cannot receive mail (typos, expired domains) go to invalidEmails and do not make a lead. emailMailServer shows the result.", "default": true }, "contactPages": { "title": "πŸ“„ Contact pages per site", "minimum": 0, "maximum": 5, "type": "integer", "description": "When the page Google links shows no email, also read up to this many contact-like pages of the site (contact, imprint / Impressum, about, appointment, team). 0 = the linked page only.", "default": 2 }, "deepSearch": { "title": "πŸ—ΊοΈ Deep search (map tiles)", "type": "boolean", "description": "When Google stops listing (its limit is ~120-200 places per search), split the area into smaller map tiles and search each, to reach more businesses in a city. Off = one search, the places Google lists first.", "default": true }, "onlyUnclaimed": { "title": "🏷️ Only unclaimed businesses", "type": "boolean", "description": "Only listings whose owner has not claimed them on Google (\"Claim this business\" on Maps): leads for Google Business Profile and local SEO services. Every row has isClaimed.", "default": false }, "onlyWithPhone": { "title": "πŸ“ž Only with a phone number", "type": "boolean", "description": "Skip places without a phone number on Google Maps.", "default": false }, "minRating": { "title": "⭐ Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only places rated at least this (1-5). Empty = any." }, "minReviews": { "title": "πŸ’¬ Minimum reviews", "minimum": 0, "type": "integer", "description": "Only places with at least this many Google reviews. Empty = any." }, "maxReviews": { "title": "πŸ†• Maximum reviews", "minimum": 0, "type": "integer", "description": "Only places with at most this many reviews: new or small businesses that need reviews and marketing. Empty = any." }, "categoryFilter": { "title": "πŸ—‚οΈ Only these categories", "type": "array", "description": "Keep places whose Google category contains one of these words: \"plumber\" drops the HVAC companies and general contractors Google also lists for \"plumber\". Empty = all.", "items": { "type": "string" } }, "skipClosed": { "title": "🚫 Skip closed places", "type": "boolean", "description": "Skip places marked temporarily or permanently closed. Every row has businessStatus.", "default": true }, "onlyNewPlaces": { "title": "πŸ”” Only new leads (no repeats)", "type": "boolean", "description": "Remember every place checked and next time skip places seen before (each new row isNew: true). First run = everything. Places seen before are free and their websites are not read again.", "default": false }, "monitorName": { "title": "🏷️ Alert name", "type": "string", "description": "Separate memory for each lead list: \"dentists-austin\", \"roofers-texas\". Same name = same list.", "default": "default" }, "searchUrls": { "title": "πŸ”— Google Maps search links", "type": "array", "description": "Links copied from Google Maps after a search, such as https://www.google.com/maps/search/coffee/@30.26,-97.74,14z. The words and the map area of the link are used.", "items": { "type": "string" } }, "placeUrls": { "title": "πŸ“Œ Place links or IDs", "type": "array", "description": "Single places: Google Maps place links, place IDs (ChIJ...), CIDs or https://maps.google.com/?cid=... links. Each becomes one row with the same fields and the emails of its website (filters apply).", "items": { "type": "string" } }, "language": { "title": "🌍 Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "nl", "pl", "sv", "da", "fi", "no", "cs", "tr", "ru", "uk", "ja", "ko", "zh-CN", "ar", "hi", "id", "th", "vi" ], "type": "string", "description": "Language of categories, opening hours and descriptions.", "default": "en" }, "countryCode": { "title": "🏳️ Country (Google region)", "type": "string", "description": "Two-letter country code Google uses for the results (us, gb, de, fr, in, au...). Set it to the country you search in.", "default": "us" }, "maxConcurrency": { "title": "⚑ Parallel requests", "minimum": 1, "maximum": 30, "type": "integer", "description": "Google Maps pages read at once (websites: four times as many).", "default": 10 }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy", "type": "object", "description": "The Actor reads Google Maps and websites directly and switches to Apify Proxy (datacenter, then residential) only if Google starts refusing; a website that refuses gets one more try through a datacenter IP.", "default": { "useApifyProxy": true } }, "debugLog": { "title": "🐞 Debug log", "type": "boolean", "description": "Log every retry.", "default": false } } }, "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 } } } } } } } } } }