{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper - $0.27/1k, Places & Reviews", "description": "Scrape Google Maps places and reviews. Each row has the business name, category, address, rating, GPS coordinates and place ID. Phone, website and review count only come back when Google shows them on the page. $0.27 per 1,000 rows.", "version": "0.1", "x-build-id": "1BNwfiZhRxtZNneJA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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", "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "One or more Google Maps searches. Include the location in the text, e.g. \"coffee in Brooklyn\", \"dentists near Eiffel Tower\", \"hotels Lisbon\".", "items": { "type": "string" } }, "searchQuery": { "title": "Single search query (alternative)", "type": "string", "description": "A single search, if you prefer one box instead of the list above." }, "reviewUrls": { "title": "Google Maps place URLs for reviews", "type": "array", "description": "Optional place URLs to open and scrape reviews from. Use this for direct review extraction; placeUrls is accepted as an alias.", "items": { "type": "string" } }, "placeUrls": { "title": "Place URLs (review alias)", "type": "array", "description": "Optional alias for reviewUrls.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Google Maps interface language code (e.g. en, de, fr, es).", "default": "en" }, "countryCode": { "title": "Proxy country", "type": "string", "description": "Optional 2-letter country to exit from (e.g. US, GB, DE). Leave empty to use the scraper's own US address pool, which is the most reliable lane. Setting a non-US country switches to rotating datacenter addresses in that country." }, "maxItems": { "title": "Max places per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many places to collect per search (the scraper scrolls the results feed to reach this). Note: website and phone are only returned when Google shows them on the results card, so those fields are often null; rating, reviewCount, category and address can also be null when Google omits them.", "default": 60 }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum newest reviews to return per place URL or discovered place.", "default": 50 }, "includeReviews": { "title": "Include reviews for search results", "type": "boolean", "description": "After collecting places, open each place and return its newest reviews too. This increases browser and proxy usage.", "default": false }, "includeOwnerReplies": { "title": "Include owner replies", "type": "boolean", "description": "Attempt to include the business owner's visible reply for each review.", "default": true }, "notionConnector": { "title": "Notion connector (optional)", "type": "string", "description": "Optional. Write each place as a page into your Notion when the run finishes. Authorize a Notion connector once in Settings → API & Integrations → MCP connectors, then pick it here. Leave empty to skip (default) — results are always saved to the dataset regardless." }, "notionParentId": { "title": "Notion target data source ID", "type": "string", "description": "Optional. The Notion data source ID of the database to write into (only used if a Notion connector is set). Leave empty to create the pages privately in your workspace instead." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave this alone unless you have your own proxy servers. The scraper already routes itself through a pool of static addresses that Google tolerates, and it rotates to a fresh one whenever a captcha appears. Metered proxy groups (RESIDENTIAL, GOOGLE_SERP) are not offered here and are swapped for rotating datacenter addresses if requested. Your OWN proxy servers, entered as custom proxy URLs, are always used exactly as given.", "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 } } }, "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 } } } } } } } } } }