{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Reviews Scraper - Unlimited Reviews Per Place",
"description": "Scrape unlimited Google Maps reviews from place URLs or IDs. Get ratings, full text, owner replies, sub-ratings, photos and reviewer details.",
"version": "0.0",
"x-build-id": "xhlpbYm8cfXfF5iIV"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~google-maps-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-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/zen-studio~google-maps-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-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/zen-studio~google-maps-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-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": "Google Maps URLs",
"maxItems": 500,
"type": "array",
"description": "The places to scrape reviews for. Accepts /maps/place/..., /maps?cid=..., and shortened maps.app.goo.gl links. Paste the links themselves; a link to a hosted list of URLs is not supported.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"placeIds": {
"title": "Place IDs",
"maxItems": 500,
"type": "array",
"description": "Google Maps place IDs like ChIJN1t_tDeuEmsRUsoyG83frY4 (the place_id: prefix is optional). Feature IDs like 0x89c25a1bd8d6f2f7:0xf28aad03aa6f0532 also work, and start fastest.",
"items": {
"type": "string",
"maxLength": 300
}
},
"maxReviewsPerPlace": {
"title": "Reviews per place",
"minimum": 0,
"type": "integer",
"description": "Stop after this many reviews per place, or earlier if the place has fewer. Set 0 for the complete history; some places have tens of thousands. Each review is billed at $0.399 per 1,000."
},
"reviewsSort": {
"title": "Sort order",
"enum": [
"newest",
"mostRelevant",
"highestRanking",
"lowestRanking"
],
"type": "string",
"description": "Newest first orders by latest activity, so an edited review counts as recent; it is the one to use for monitoring. Most relevant matches what the Google Maps page shows by default. Combine Lowest rating first with a small Reviews per place to pull just the complaints.",
"default": "newest"
},
"newerThan": {
"title": "Only reviews newer than",
"maxLength": 40,
"type": "string",
"description": "A date (2026-08-01) or a rolling period (7 days, 3 months). A period is measured from the moment the run starts, so scheduled runs keep the same window instead of drifting. Compared against each review's latest activity, so a review edited inside the window is kept even if it was first posted years ago. Dates with no time zone are read as UTC; a month counts as 30 days. Leave blank for no cutoff. Setting this forces Newest first."
},
"reviewsKeyword": {
"title": "Reviews mentioning",
"maxLength": 200,
"type": "string",
"description": "Keep only reviews about a topic, e.g. parking or breakfast. Matches the way the search box on the Google Maps reviews panel does, so related wording is included, not just the exact word. Leave blank for all reviews."
},
"reviewsOrigin": {
"title": "Review sources",
"enum": [
"all",
"google"
],
"type": "string",
"description": "Places like hotels also show reviews syndicated from partner sites. Restrict to Google-native reviews if you only want first-party ratings.",
"default": "all"
},
"language": {
"title": "Language",
"enum": [
"en",
"de",
"fr",
"es",
"it",
"pt",
"nl",
"pl",
"ja",
"zh-CN",
"zh-TW",
"ko",
"ar",
"tr",
"ru"
],
"type": "string",
"description": "Display language for place names, categories, and relative dates. Review text is always returned in the language it was written in.",
"default": "en"
},
"countryCode": {
"title": "Country",
"maxLength": 2,
"type": "string",
"description": "Two-letter country code used when loading each place, e.g. de. Affects regional labels only, not which reviews are returned.",
"default": "us"
},
"parentActor": {
"title": "Parent Actor",
"maxLength": 100,
"type": "string",
"description": "Optional integration label for orchestrated runs. It does not change scraping or output.",
"default": ""
}
}
},
"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
}
}
}
}
}
}
}
}
}
}