{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Reviews Scraper — Photos, Ratings & Translations",
"description": "Scrape Google Maps reviews by place URL or place ID. Get review text with English translation, star ratings, attached photos, likes, owner responses, dates, and reviewer profiles — 20 fields. $0.50 per 1,000 reviews; pay only for what you get.",
"version": "2.0",
"x-build-id": "UIaYpI8tewZxvAnvc"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/herus13~google-maps-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-herus13-google-maps-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/herus13~google-maps-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-herus13-google-maps-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/herus13~google-maps-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-herus13-google-maps-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": "Place URLs",
"type": "array",
"description": "Google Maps place URLs to scrape reviews from. Open the place in Google Maps, copy the full URL from your browser's address bar, and paste it here (one per line). Example: https://www.google.com/maps/place/Trà+sữa+Feeling+Tea/@9.29,105.73,17z/data=!4m8!3m7!1s0x31a1090bfc613b0d:0x236a0a4f8f3febce!.... See the README for how to get a place URL.",
"items": {
"type": "string"
}
},
"placeIds": {
"title": "Place IDs",
"type": "array",
"description": "Raw Google place IDs in the hex feature-id form 0x…:0x…. Most users should paste a Place URL above instead — use this only if you already have hex IDs. ChIJ… IDs are not supported; paste the place's URL instead.",
"items": {
"type": "string"
}
},
"maxReviews": {
"title": "Max reviews per place",
"type": "integer",
"description": "Maximum number of reviews to scrape per place. Set to 0 for unlimited. Note: Google counts star-only ratings (no text) in a place's total, but only reviews with text are returned as records.",
"default": 100
},
"reviewsSort": {
"title": "Sort order",
"enum": [
"newest",
"mostRelevant",
"highestRating",
"lowestRating"
],
"type": "string",
"description": "Order of returned reviews. Use Highest rating first with a small Max reviews to get a place's top reviews; Newest first for monitoring fresh feedback.",
"default": "newest"
},
"language": {
"title": "Language",
"type": "string",
"description": "BCP-47 language code for review text (e.g. en, de, fr, vi). Affects the language Google returns review text in.",
"default": "en"
},
"proxyProvider": {
"title": "Proxy provider",
"enum": [
"default",
"dataimpulse",
"apify",
"custom",
"disabled"
],
"type": "string",
"description": "Default routes the run through DataImpulse residential IPs (falling back to Apify Proxy) and is included in the price of the run. Custom uses the proxy URLs you enter below; Apify Proxy uses the proxy configuration below; No proxy connects directly. Leave this empty to keep the behaviour this actor already had — nothing is imposed on a run that does not choose."
},
"proxyUrls": {
"title": "Custom proxy URLs",
"type": "array",
"description": "Only read when Proxy provider is Custom. One gateway URL per entry, e.g. http://user:pass@host:port — works with any provider that issues URLs (BrightData, Oxylabs, SmartProxy, your own). Leave empty for any other Proxy provider.",
"items": {
"type": "string"
}
},
"proxy": {
"title": "Proxy",
"type": "object",
"description": "Proxy configuration. Residential proxies are recommended — Google rate-limits datacenter IPs aggressively for review endpoints."
},
"debugDumpRaw": {
"title": "Debug: dump raw API response",
"type": "boolean",
"description": "If on, the first raw batchexecute reviews response is saved to the key-value store (key DEBUG_LISTUGCPOSTS_RAW) for troubleshooting. Leave off for normal runs.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}