{ "openapi": "3.0.1", "info": { "title": "Google Maps Leads Scraper", "description": "A fast, high-performance scraper built for lead generation, competitor analysis, and business intelligence. Extracts detailed business profiles, including name, contact details, emails, phone numbers, location, ratings, and reviews from Google. Supports custom search URLs, proxy rotation, and pag...", "version": "1.1", "x-build-id": "SbigDeB7h8YeMWOdM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codingfrontend~google-maps-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codingfrontend-google-maps-leads-scraper", "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/codingfrontend~google-maps-leads-scraper/runs": { "post": { "operationId": "runs-sync-codingfrontend-google-maps-leads-scraper", "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/codingfrontend~google-maps-leads-scraper/run-sync": { "post": { "operationId": "run-sync-codingfrontend-google-maps-leads-scraper", "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", "minItems": 1, "maxItems": 50, "type": "array", "description": "Unique, nonempty Google Maps searches. Each term is capped independently.", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "categories": { "title": "Beauty and spa categories", "minItems": 1, "maxItems": 50, "type": "array", "description": "Target-compatible aliases. Each category becomes a bounded public Google Maps search term.", "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "sourceCategories": { "title": "Source category labels", "maxItems": 20, "type": "array", "description": "Target-compatible parent labels retained as provenance. Google Maps is the actual public source used by this equivalent.", "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "matchType": { "title": "Category match type", "enum": [ "any_character", "full_word" ], "type": "string", "description": "Target-compatible category matching label; Google Maps receives the category phrase directly.", "default": "any_character" }, "limit": { "title": "Target result limit", "minimum": 100, "maximum": 10000, "type": "integer", "description": "Target-compatible total result limit. The maintained Google Maps equivalent remains bounded to 500 results per category search.", "default": 500 }, "maxLeads": { "title": "Maximum leads per search term", "minimum": 1, "maximum": 500, "type": "integer", "description": "A positive, exact upper bound per term. Global deduplication can make later terms emit fewer records.", "default": 20 }, "language": { "title": "Maps language", "pattern": "^[a-z]{2,3}(?:-[A-Z]{2})?$", "type": "string", "description": "BCP 47-style language code, for example en or pt-BR.", "default": "en" }, "country": { "title": "Search country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter country code used by Google Maps localization, for example US, GB, or IN.", "default": "US" }, "fingerprintProfile": { "title": "Browser identity", "enum": [ "chrome-windows", "chrome-macos" ], "type": "string", "description": "A coherent desktop Chrome user-agent, platform, viewport, locale, and timezone profile.", "default": "chrome-windows" }, "proxySessionId": { "title": "Fixed proxy session ID", "pattern": "^(?:[\\w._~]+)?$", "maxLength": 50, "type": "string", "description": "Optional session label. Leave blank for rotating proxy sessions.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Defaults to Apify Residential. Set useApifyProxy to false for direct access.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }