{ "openapi": "3.0.1", "info": { "title": "Google Maps Lead Extractor — Business Emails, Phones & Socials", "description": "Turn a Google Maps search into a contact list: one row per business with a verified email, phone and social profiles scraped from its website, plus address, category, rating and reviews. Query like \"dentists in Austin, TX\". Leads mode bills only for rows that carry a contact.", "version": "0.1", "x-build-id": "htbeivTdBCRsn79eA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/juramoshkov~google-maps-lead-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-juramoshkov-google-maps-lead-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/juramoshkov~google-maps-lead-extractor/runs": { "post": { "operationId": "runs-sync-juramoshkov-google-maps-lead-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/juramoshkov~google-maps-lead-extractor/run-sync": { "post": { "operationId": "run-sync-juramoshkov-google-maps-lead-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": { "mode": { "title": "Mode", "enum": [ "leads", "places" ], "type": "string", "description": "leads — one row per business WITH a verified email, phone and social profiles scraped from its website. Use this to build a contact list. places — one row per business with Google Maps data only (name, address, phone, rating), no website enrichment and far cheaper per row.", "default": "leads" }, "queries": { "title": "Search queries", "type": "array", "description": "One \"what in where\" phrase per line, exactly as you would type it into Google Maps. For example \"coffee shops in Berlin, Germany\" or \"dentists in Austin, TX\". Each line is searched independently. Defaults to one query so a run with no input still returns data.", "default": [ "coffee shops in Berlin, Germany" ], "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Billable rows to return across the whole run. Defaults to 5 so a trial run stays cheap; raise it once the output is what you need, or set it high and use Max spend to bound the run by budget. In leads mode a row is billable only when it carries an email or a social profile; businesses with just a Google phone still appear but cost nothing.", "default": 5 }, "maxBudgetUsd": { "title": "Max spend for this run (USD)", "minimum": 0, "type": "integer", "description": "Hard ceiling on what this run can charge. It is converted to a row count before the first request, so the run stops on its own rather than billing past it. Set 0 to remove the ceiling and rely on Max results alone.", "default": 5 }, "region": { "title": "Region (country code)", "type": "string", "description": "Optional Google region, e.g. \"us\", \"de\", \"gb\". Narrows results to one country's Google Maps. Leave empty to let the query's own \"in \" decide." }, "language": { "title": "Language", "type": "string", "description": "Optional UI language code, e.g. \"en\", \"de\". Leave empty for the region default." }, "requestDelayMs": { "title": "Request delay (ms)", "minimum": 0, "type": "integer", "description": "Pause between upstream requests. The provider plan sets the floor: Pro allows 5/sec, Ultra 8/sec, Mega 10/sec. 0 means as fast as the plan allows.", "default": 0 }, "apiKey": { "title": "OpenWeb Ninja API key (optional)", "type": "string", "description": "Bring your own OpenWeb Ninja key. Leave empty to use the Actor's key." } } }, "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 } } } } } } } } } }