{ "openapi": "3.0.1", "info": { "title": "Google Maps Review Monitoring — Google Reviews Scraper", "description": "Google Maps review monitoring: reviewer, star rating, text, date, owner replies and likes for any place URL, name or search. Schedule it to track new reviews. Full review feed up to your limit when Google serves it; otherwise the preview reviews, flagged per row. No API key.", "version": "0.0", "x-build-id": "J2TLPtoTh3LDqxGAD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~google-maps-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-google-maps-reviews", "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/nexgendata~google-maps-reviews/runs": { "post": { "operationId": "runs-sync-nexgendata-google-maps-reviews", "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/nexgendata~google-maps-reviews/run-sync": { "post": { "operationId": "run-sync-nexgendata-google-maps-reviews", "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": { "placeUrls": { "title": "Google Maps Place URLs", "type": "array", "description": "Place URLs for the Google Maps reviews scraper. Google Maps place URLs (https://www.google.com/maps/place/...). One record is returned per review for each place. You can also paste a Maps search URL. NO Google API key required. Leave blank and use Search Queries instead if you only have a business name.", "default": [], "items": { "type": "string" } }, "searchQueries": { "title": "Search Queries / Place Names", "type": "array", "description": "Business names or search queries — e.g. 'Franklin Barbecue Austin TX', 'Eiffel Tower Paris'. The scraper opens the top matching place and extracts its reviews. Use this when you don't have a direct place URL.", "default": [], "items": { "type": "string" } }, "maxReviews": { "title": "Maximum Reviews Per Place", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of reviews to extract per place. Reviews are sorted by newest first and the feed is scrolled to lazy-load up to this many. 30 for a quick scan, up to a few thousand for full coverage.", "default": 100 }, "max_reviews": { "title": "Maximum Reviews (alias)", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Alias of maxReviews." }, "placeNames": { "title": "Place Names (alias)", "type": "array", "description": "Alias of Search Queries. List of business/place names to look up and scrape reviews for.", "items": { "type": "string" } }, "queries": { "title": "Queries (alias)", "type": "array", "description": "Alias of Search Queries for users coming from other Apify scrapers.", "items": { "type": "string" } }, "urls": { "title": "URLs (alias)", "type": "array", "description": "Alias of Place URLs. Accepts Google Maps place URLs.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (alias)", "type": "array", "description": "Alias of Place URLs. Accepts plain strings or {url: ...} dict items." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy used to scrape Google Maps. Apify RESIDENTIAL proxy is strongly recommended (and used by default) — Google Maps is anti-bot defended.", "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 }, "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 } } } } } } } } } }