Google Maps Reviews Scraper Pro
Pricing
$0.50 / 1,000 results
Extract Google Maps reviews with review text, ratings, dates, photos, and owner responses for reputation management, local SEO, and market research. Filter by date and rating, isolate photo or owner-answered reviews, skip textless reviews, and get a per-place analytics summary.
You can access the Google Maps Reviews Scraper Pro programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "2krm2NpPzQl6vYOUZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/goldenbios~my-actor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-goldenbios-my-actor", "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/goldenbios~my-actor/runs": { "post": { "operationId": "runs-sync-goldenbios-my-actor", "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/goldenbios~my-actor/run-sync": { "post": { "operationId": "run-sync-goldenbios-my-actor", "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": { "diagnosticMode": { "title": "Diagnostic mode (search-resolve probe)", "type": "boolean", "description": "Measurement only: resolves each target via the /maps/search page through the proxy and attempts one session-bound review RPC page; writes type='diagnostic' items instead of scraping.", "default": false }, "includeSummary": { "title": "Include per-place summary", "type": "boolean", "description": "Emit one summary item per place: rating histogram, average rating, % answered, % with photos, reviews per month, and completeness (fetched vs Google's reported total).", "default": true }, "language": { "title": "Language", "type": "string", "description": "Language code for the results (e.g. en, fr, de, es, ar).", "default": "en" }, "maxPagesSafety": { "title": "Max pages safety cap", "minimum": 1, "type": "integer", "description": "Internal safety guard: maximum RPC pages fetched per place (20 reviews per page). Pagination normally stops on its own when Google runs out of reviews.", "default": 10000 }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Only reviews with at most this rating (1-5). Combine with Minimum rating for a range, e.g. 1-2 to mine unhappy customers." }, "maxReviews": { "title": "Max reviews per place", "minimum": 1, "type": "integer", "description": "Maximum number of reviews to return per place. The default fetches everything Google will serve.", "default": 10000000 }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Only reviews with at least this rating (1-5)." }, "onlyUnanswered": { "title": "Only unanswered reviews", "type": "boolean", "description": "Skip reviews that already have an owner response. Ideal for reputation-management prospecting.", "default": false }, "onlyWithOwnerResponse": { "title": "Only reviews with an owner response", "type": "boolean", "description": "Skip reviews the business never answered.", "default": false }, "onlyWithPhotos": { "title": "Only reviews with photos", "type": "boolean", "description": "Skip reviews that have no photos.", "default": false }, "personalData": { "title": "Include personal data", "type": "boolean", "description": "When off, reviewer names, profile links, avatars and reviewer stats are removed from the output.", "default": true }, "placeIds": { "title": "Place IDs", "type": "array", "description": "Google Place IDs (ChIJ...) or Maps feature IDs (0x...:0x...). Place IDs are resolved to feature IDs automatically.", "default": [], "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google blocks requests from datacenter IP addresses (HTTP 403), which is why this actor runs its browser through a proxy. Residential proxies are strongly recommended and are the default below. You pay only your own run's proxy usage; traffic is small because the browser blocks images and map tiles." }, "resume": { "title": "Resume interrupted runs (RESUME)", "type": "boolean", "description": "Progress is saved after every page. If a run is restarted, already-fetched pages are skipped instead of re-scraped.", "default": true }, "reviewsEndDate": { "title": "Reviews until date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only reviews published on or before this date (YYYY-MM-DD). The other scraper has no end date; this one does." }, "reviewsFilterString": { "title": "Keyword filter", "type": "string", "description": "Only reviews whose text contains this keyword (case-insensitive).", "default": "" }, "reviewsOrigin": { "title": "Reviews origin", "enum": [ "all", "google" ], "type": "string", "description": "'all' keeps reviews from every source Google aggregates; 'google' keeps native Google reviews only.", "default": "all" }, "reviewsSort": { "title": "Sort reviews by", "enum": [ "newest", "mostRelevant", "highestRanking", "lowestRanking" ], "type": "string", "description": "Sort order. 'newest' always fetches fresh (no cached pages).", "default": "newest" }, "reviewsStartDate": { "title": "Reviews from date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only reviews published on or after this date (YYYY-MM-DD)." }, "skipTextlessReviews": { "title": "Skip textless reviews", "type": "boolean", "description": "Exclude star-only reviews with no written text.", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Google Maps place URLs. Short links work too: share.google.com, goo.gl/maps and maps.app.goo.gl URLs are resolved automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Google Maps Reviews Scraper Pro from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: