{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper", "description": "The Google Maps Scraper is an Apify Actor designed to extract business listings from Google Maps. It supports scraping by any search keyword, city, or category and returns clean, structured data including contact details, ratings, hours, and GPS coordinates.", "version": "0.0", "x-build-id": "f1OtvvVGpyLtXbZZH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/techforce.global~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-techforce.global-google-maps-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/techforce.global~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-techforce.global-google-maps-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/techforce.global~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-techforce.global-google-maps-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "One or more Google Maps search terms, e.g. \"restaurants in Delhi\" or \"dentists near Ahmedabad\". Each query is run separately and capped independently by Max Results.", "default": [ "restaurants in Mumbai" ], "items": { "type": "string" } }, "maxResults": { "title": "Max Results Per Query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum places to scrape PER QUERY (1-500). Google Maps itself stops feeding results at roughly 120 per search, so values far above that will not return more. Free Apify plans are capped at 5 per query.", "default": 20 }, "language": { "title": "Language", "enum": [ "en", "hi", "fr", "de", "es" ], "type": "string", "description": "Language for the Google Maps interface and results. Affects category names, opening-hours labels and review wording in the output.", "default": "en" }, "batchSize": { "title": "Batch size (concurrent pages)", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many place pages to open at once. Higher is faster but uses more memory and is more likely to trip Google Maps rate limiting. 5 is a safe default; raise it only if runs are slow and completing cleanly.", "default": 5 }, "mcpConnector": { "title": "Deliver to (MCP connector)", "type": "string", "description": "Optionally deliver the scraped places into a connector you have authorized - Notion, Slack, Airtable, Google Sheets, HubSpot, or any MCP-compatible connector. Leave empty to only save results to the dataset." }, "deliveryMode": { "title": "Delivery mode", "enum": [ "perPlace", "chunked", "summary", "none" ], "type": "string", "description": "How to deliver to the connector: 'perPlace' (one call per business - best for a CRM row each), 'chunked' (split a long list across a few calls so services like Notion never time out), 'summary' (one call listing every place), or 'none' (save to dataset only).", "default": "perPlace" }, "mcpTool": { "title": "Connector tool name", "type": "string", "description": "Name of the tool to call on the connector (e.g. 'create_record' for Airtable, 'create_page' for Notion, 'send_message' for Slack, 'append_row' for Google Sheets). If unsure, run once with a connector selected - the log lists the connector's available tools and the chosen tool's expected argument schema.", "default": "" }, "mcpArguments": { "title": "Connector tool arguments", "type": "object", "description": "Arguments passed to the connector tool. String values support {placeholders}. In 'perPlace' mode: {name}, {category}, {rating}, {reviewCount}, {address}, {phone}, {website}, {hours}, {tags}, {latitude}, {longitude}, {coordinates}, {imageUrl}, {plusCode}, {url}, {searchQuery}, {place} (a formatted multi-line block) and {message} (the rendered template below). In 'summary'/'chunked' modes: {placeCount}, {queries}, {language}, {withPhone}, {withWebsite}, {places} (every place, or one part of them in chunked mode), {part}/{partCount} (chunked mode only) and {message}. Example for Airtable: {\"fields\": {\"Name\": \"{name}\", \"Phone\": \"{phone}\", \"Website\": \"{website}\"}}. Example for Slack: {\"channel\": \"#leads\", \"text\": \"{message}\"}.", "default": {} }, "mcpMessageTemplate": { "title": "Message template", "type": "string", "description": "Optional template rendered and exposed as the {message} placeholder in the tool arguments. Per-place example: '{name} ({rating}, {reviewCount})\\n{address}\\n{phone} - {website}'. Summary example: '{placeCount} places for {queries} - {withPhone} with a phone number:\\n\\n{places}'.", "default": "" } } }, "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 } } } } } } } } } }