{ "openapi": "3.0.1", "info": { "title": "Google Maps B2B Leads & Reviews Scraper", "description": "Extract Google Maps business leads, contact details, ratings, locations, and optional review rows for sales, research, and local SEO.", "version": "1.22", "x-build-id": "2kofHYLFkCNgFI4oV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thescrapelab~Apify-Google-Maps-B2B-Extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thescrapelab-Apify-Google-Maps-B2B-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/thescrapelab~Apify-Google-Maps-B2B-Extractor/runs": { "post": { "operationId": "runs-sync-thescrapelab-Apify-Google-Maps-B2B-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/thescrapelab~Apify-Google-Maps-B2B-Extractor/run-sync": { "post": { "operationId": "run-sync-thescrapelab-Apify-Google-Maps-B2B-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search Queries", "maxItems": 50, "type": "array", "description": "Add one or more Google Maps searches, for example 'Plumbers in Chicago' or 'HVAC near Dallas'.", "items": { "type": "string" } }, "maxPlacesPerQuery": { "title": "Businesses per Query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of businesses to collect for each search query. Keep this lower for cheaper, more reliable runs; split very large jobs into multiple runs.", "default": 1 }, "includeReviews": { "title": "Extract Reviews", "type": "boolean", "description": "Turn review extraction on or off. When enabled, review rows are written into the same default dataset as business rows and can be filtered by the 'type' field. This mode is slower and more expensive, and some listings still expose only a limited top-review set.", "default": false }, "reviewsPerBusiness": { "title": "Reviews per Business", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of reviews to collect for each business when review extraction is enabled. Higher values are slower and cost more. Maximum 500." }, "sectionAdvanced": { "title": "Advanced Settings", "type": "boolean", "description": "Open to customize language and performance.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Language for the Google Maps interface (ISO code).", "default": "en" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 4, "type": "integer", "description": "Maximum number of browser pages to run in parallel. Use 1 for smoke tests and small reliability checks.", "default": 2 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "How many times Crawlee should retry failed search or detail requests. Use 0 for bounded smoke tests.", "default": 1 }, "searchNavigationTimeoutSecs": { "title": "Search timeout seconds", "minimum": 20, "maximum": 240, "type": "integer", "description": "Maximum time to wait for a Google Maps search page navigation. Use lower values for smoke tests to avoid long blocked sessions." }, "detailNavigationTimeoutSecs": { "title": "Detail timeout seconds", "minimum": 20, "maximum": 240, "type": "integer", "description": "Maximum time to wait for an individual business detail page navigation." }, "requestHandlerTimeoutSecs": { "title": "Request handler timeout seconds", "minimum": 60, "maximum": 600, "type": "integer", "description": "Maximum time to spend processing one queued request." } } }, "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 } } } } } } } } } }