{ "openapi": "3.0.1", "info": { "title": "Google Maps Place Reviews Scraper", "description": "Export Google Maps reviews for any place: review text, stars, exact dates, reviewer, owner responses, photos, aspect ratings and place rating. Use place URLs, IDs or name + city. Fast HTTP, no login.", "version": "0.1", "x-build-id": "fmKoZ4zoofvEhrb3L" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~google-maps-place-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-google-maps-place-reviews-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/automation-lab~google-maps-place-reviews-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-google-maps-place-reviews-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/automation-lab~google-maps-place-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-google-maps-place-reviews-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": { "startUrls": { "title": "Google Maps place URLs", "type": "array", "description": "Google Maps place URLs. Supported forms: full place URLs (google.com/maps/place/...), short share links (maps.app.goo.gl/...), URLs with ?cid=, and URLs with place_id:. Each URL is one place. Search-result URLs with many places are not expanded; use Search queries instead.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "placeIds": { "title": "Place IDs", "type": "array", "description": "Google place IDs such as ChIJPTacEpBQwokRKwIlDXelxkA (the ID used by the Google Places API). Feature IDs in the 0x...:0x... form are accepted too.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Business name plus location, for example \"Katz's Delicatessen New York\". Each query is resolved to the single best-matching Google Maps place, and that place's reviews are exported. For chains, Google's top-ranked branch is used; add the street or use the place URL to target a specific branch.", "items": { "type": "string" } }, "maxReviews": { "title": "Max reviews per place", "minimum": 0, "type": "integer", "description": "Maximum number of reviews saved for each place, after filters. Set 0 to export all reviews Google lists for the place. You pay per saved review.", "default": 100 }, "reviewsSort": { "title": "Sort reviews by", "enum": [ "newest", "mostRelevant", "highestRanking", "lowestRanking" ], "type": "string", "description": "Order in which Google returns reviews. \"Newest\" is best for monitoring and is required for the start-date filter to stop early.", "default": "newest" }, "reviewsStartDate": { "title": "Only reviews published since", "type": "string", "description": "Keep only reviews published on or after this date. Use YYYY-MM-DD (for example 2026-01-01) or a relative window such as \"30 days\", \"2 weeks\", \"6 months\", \"1 year\". With Newest sort, the scraper stops paging exactly at the first older review. With other sorts, older reviews are skipped and the filter read limit applies (300 reviews per place, then at least one match per 15 read), so older matches deep in the list can be missed; use Newest sort for complete date windows. Google's exact timestamp is used; for edited reviews this is the time of the last edit." }, "reviewsFilterString": { "title": "Keyword filter", "type": "string", "description": "Keep only reviews whose text contains this phrase (case-insensitive substring match on the original text and on Google's translation). Matching happens after download: per place the scraper reads 300 reviews, then keeps reading only while it finds at least one match per 15 reviews read. Very rare phrases may therefore stop early." }, "starRatings": { "title": "Star ratings", "type": "array", "description": "Keep only reviews with these star ratings. Leave empty for all ratings. Tip: combine with \"Lowest rating\" sort for 1-2 star reviews or \"Highest rating\" for 4-5 star reviews; the scraper then stops as soon as Google's sorted list moves past your ratings. With other sorts, filtering uses the same read limit as the keyword filter.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "language": { "title": "Language", "type": "string", "description": "Language code for Google's interface and translations, for example en, de, fr, es, pt-BR. Original review text is always kept in `text`; when a review is in another language, Google's translation into this language is added in `textTranslated`.", "default": "en" }, "personalData": { "title": "Include reviewer personal data", "type": "boolean", "description": "Include reviewer name, profile ID, profile URL and photo. Turn off to export reviews without personal data (GDPR-friendly). Reviewer review/photo counts and Local Guide status are kept.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is used by default (datacenter). The default works for nearly all runs. Residential and Google SERP proxy groups are not supported and stop the run at once with a clear error; you can use your own proxy URLs instead.", "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 } } } } } } } } } }