{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper", "description": "Extract business data from Google Maps: names, ratings, reviews, phone numbers, addresses, websites, and Plus Codes. Deep extraction visits each business for accurate, complete data. Ideal for lead generation, market research, and local SEO analysis.", "version": "0.0", "x-build-id": "SQa1nFxfD0345vN11" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamech~apify-google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamech-apify-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/datamech~apify-google-maps-scraper/runs": { "post": { "operationId": "runs-sync-datamech-apify-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/datamech~apify-google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-datamech-apify-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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What to search for on Google Maps, exactly as you would type it in the Maps search box (e.g. 'dentists in Austin TX', 'coffee shops in Brooklyn'). Each term is scraped separately.", "default": [ "coffee shops in Brooklyn" ], "items": { "type": "string" } }, "maxItems": { "title": "Max places per search term", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of places to return for each search term. Google Maps itself returns at most about 120-160 places per query; to collect more, split the area into several search terms (e.g. by neighborhood or ZIP code).", "default": 5 }, "location": { "title": "Location (optional)", "type": "string", "description": "Optional location text appended to every search term, e.g. 'Austin TX' turns 'dentists' into 'dentists Austin TX'. Leave empty if your search terms already contain a location." }, "language": { "title": "Language", "type": "string", "description": "Language of the results (categories, opening-hours day names, etc.) as a Google language code, e.g. 'en', 'es', 'de', 'fr', 'pt-BR'.", "default": "en" }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Attach individual reviews (text, stars, reviewer, date, photos, owner response) to every place in a reviews array. Up to 50 reviews per place are included free in the per-place price. Rating and total review count are always included.", "default": true }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 0, "maximum": 500, "type": "integer", "description": "How many reviews to attach to each place (0-500). Up to 50 reviews per place are included free; additional reviews (51-500) cost $0.10 per 1,000. Places with fewer reviews return all of them.", "default": 5 }, "reviewsSort": { "title": "Sort reviews by", "enum": [ "newest", "mostRelevant", "highestRating", "lowestRating" ], "type": "string", "description": "Which reviews to return first.", "default": "newest" }, "reviewsLanguage": { "title": "Reviews language (optional)", "type": "string", "description": "Google language code used for reviews, e.g. 'en', 'es', 'de'. Google favors reviews written in this language and adds machine translations for others. Defaults to the Language field above." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy (default) is recommended for reliable scraping.", "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 } } } } } } } } } }