{ "openapi": "3.0.1", "info": { "title": "Google Maps Email Scraper: Verified Business Emails & Phones", "description": "Get business emails from Google Maps search results. Each email's domain is checked for a live mail server, and you pay only for businesses that come back with a working email. Places with no email are free. Includes phone, website, address, rating and hours. No login. Works in AI agents via MCP.", "version": "0.2", "x-build-id": "k5j5oOnVoPN6Gizce" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~maps-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-maps-leads", "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/themineworks~maps-leads/runs": { "post": { "operationId": "runs-sync-themineworks-maps-leads", "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/themineworks~maps-leads/run-sync": { "post": { "operationId": "run-sync-themineworks-maps-leads", "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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "What to search on Google Maps, one search per line, written the way you would type it into Maps. Each line is its own search. Include the place in the search (\"dentists in Boise ID\") or give a plain business type (\"dentists\") and fill in Location below.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Optional. A city, region or address, for example \"Austin, TX\" or \"Leeds, UK\". When set, \" in \" is added to every search that does not already name it. Leave empty if your searches already include the place." }, "maxLeadsPerQuery": { "title": "Max places per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Most new places to process for each search, from 1 to 200. Places with and without an email both count toward this number, but only places with a working email are charged. A narrow search often has fewer places than this. For more places, add more specific searches, for example by neighbourhood or suburb.", "default": 5 }, "verifyEmails": { "title": "Verify emails (MX check)", "type": "boolean", "description": "On (recommended): every email found is checked for a live mail server on its domain, and only businesses with at least one email that passes are charged. Off: the check is skipped and any extracted email is charged, verified or not.", "default": true }, "includeFields": { "title": "Fields to include in output", "type": "array", "description": "Which business fields to keep in each row, for example just name, phone and email. Removing a field only trims the row you receive; email, status and billing fields are always kept.", "items": { "type": "string", "enum": [ "name", "address", "phone", "website", "email", "rating", "hours", "category", "coordinates" ] }, "default": [ "name", "address", "phone", "website", "email", "rating", "hours", "category", "coordinates" ] }, "deduplicateAcrossRuns": { "title": "Skip places delivered in earlier runs", "type": "boolean", "description": "On: remembers every place this actor has delivered to your account (in a key-value store named maps-leads-seen) and skips it on later runs, so you are never charged twice for the same business. The summary row reports how many were skipped. Turn off, or delete that store in Apify Storage, to get them again.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Google Maps interface language code, for example \"en\" for English or \"de\" for German. Affects category names and opening hours labels.", "default": "en" }, "proxyConfig": { "title": "Proxy configuration", "type": "object", "description": "Defaults to Apify datacenter proxy, which is enough for the public Google Maps search endpoint and business websites. Change it only if you hit blocks.", "default": { "useApifyProxy": 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 } } } } } } } } } }