# Google Maps Reviews Scraper | 💰 $0.25 per 1,000 results (`solidcode/google-maps-reviews-scraper`) Actor Scrape Google Maps reviews at scale. Extract review text, ratings, reviewer details, owner responses, photos, and more for any place on Google Maps. - **URL**: https://apify.com/solidcode/google-maps-reviews-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Automation, Other, Developer tools - **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.25 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Google Maps Reviews Scraper Extract Google Maps reviews at scale. Get review text, star ratings, reviewer details, owner responses, photos, and Local Guide badges for any place on Google Maps — sorted, filtered, and ready for analysis. Supports 30+ languages and 50+ countries. ### Why This Scraper? - **Up to 50,000 reviews per place** - Scrape 10, 1,000, or thousands of reviews from a single place - **Multiple input methods** - Paste Google Maps URLs, place IDs (ChIJ...), or just search by name - **Smart filtering** - Filter by star rating, date range, or text-only reviews before results hit your dataset - **4 sort options** - Most Relevant, Newest First, Highest Rating, or Lowest Rating - **Rich reviewer data** - Names, profile URLs, photos, and Local Guide badges (when available) - **Owner responses included** - Capture business replies alongside the original review - **Review photos** - Extract photo URLs attached to reviews - **30+ languages** - Get reviews in English, Spanish, Japanese, Arabic, and many more - **Lowest price on Apify** - $3.00 per 1,000 reviews with no hidden fees ### Use Cases **Reputation Monitoring & Brand Management** - Track new reviews across all your locations in one place - Monitor competitor review sentiment and trends over time - Identify recurring complaints or praise themes for operational improvements **Market Research & Competitive Intelligence** - Compare review volumes and ratings across competitors in a market - Analyze customer sentiment by category (restaurants, hotels, clinics, etc.) - Spot emerging trends from what customers praise or criticize **Lead Generation & Sales** - Find businesses with low ratings that could benefit from your service - Identify locations with high review volume as potential partnership targets - Build prospect lists filtered by rating and review activity **Academic & Data Science** - Gather large review datasets for NLP and sentiment analysis research - Study rating distributions and reviewer behavior patterns - Analyze geographic and temporal trends in customer feedback ### Getting Started #### Simple: Paste Place URLs The fastest way to start — paste one or more Google Maps place URLs: ```json { "placeUrls": [ "https://www.google.com/maps/place/Eiffel+Tower/@48.8583701,2.2944813" ], "maxReviewsPerPlace": 100 } ```` #### Search by Name Don't have a URL? Just search for the place: ```json { "searchQueries": ["Central Park New York", "Sagrada Familia Barcelona"], "maxReviewsPerPlace": 200 } ``` #### Filtered Reviews Zero in on exactly the reviews you need: ```json { "placeUrls": ["https://www.google.com/maps/place/..."], "maxReviewsPerPlace": 500, "sortBy": "newest", "minReviewRating": 1, "maxReviewRating": 3, "onlyWithText": true, "reviewsStartDate": "2024-01-01" } ``` #### Multi-Language Reviews Get reviews displayed in a specific language: ```json { "searchQueries": ["Tokyo Tower"], "maxReviewsPerPlace": 100, "language": "ja", "countryCode": "JP" } ``` ### Input Reference #### Places | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `placeUrls` | string\[] | `[]` | Google Maps place URLs or place IDs (ChIJ...) | | `searchQueries` | string\[] | `[]` | Search queries to find places (e.g. "Eiffel Tower Paris") | #### Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxReviewsPerPlace` | integer | `100` | Max reviews to collect per place. Set to 0 to collect up to 50,000 reviews | | `sortBy` | string | `"relevant"` | Sort order: Most Relevant, Newest First, Highest Rating, or Lowest Rating | | `language` | string | `"en"` | Language for the Google Maps interface (30+ supported) | | `countryCode` | string | Auto-detect | Country context for results (50+ countries) | #### Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `reviewsStartDate` | string | | Only include reviews on or after this date (YYYY-MM-DD) | | `minReviewRating` | integer | | Minimum star rating (1-5) | | `maxReviewRating` | integer | | Maximum star rating (1-5) | | `onlyWithText` | boolean | `false` | Skip rating-only reviews without text | ### Output Each review contains up to 15 structured fields. Here's an example: ```json { "placeName": "Carmine's - Times Square", "placeUrl": "https://www.google.com/maps/place/...", "reviewerName": "Sarah M.", "reviewerUrl": "https://www.google.com/maps/contrib/1234567890", "reviewerPhotoUrl": "https://lh3.googleusercontent.com/...", "isLocalGuide": false, "rating": 5, "reviewText": "Incredible family-style Italian food! The portions are massive and perfect for sharing. We had the vodka rigatoni and chicken parm — both outstanding. Service was attentive even on a busy Saturday night.", "publishedAt": "2 months ago", "publishedAtTimestamp": 1706745600, "language": "en", "responseFromOwnerText": "Thank you for the wonderful review, Sarah! We're so glad you enjoyed the rigatoni. Hope to see you again soon!", "responseFromOwnerDate": "2024-02-15", "reviewPhotoUrls": ["https://lh3.googleusercontent.com/..."], "reviewId": "ChdDSUhNMG9...", "reviewUrl": "https://www.google.com/maps/reviews/data=ChdDSUhNMG9...", "source": "Google", "placeFeatureId": "0x89c259af3367d0f5:0x3bdb6f7c1c5b8b5d" } ``` #### All Available Fields | Field | Type | Description | |-------|------|-------------| | `placeName` | string | Name of the reviewed place | | `placeUrl` | string | Google Maps URL of the place | | `placeFeatureId` | string | Google internal feature ID for the place | | `reviewerName` | string | Reviewer's display name | | `reviewerUrl` | string | Reviewer's Google Maps profile URL | | `reviewerPhotoUrl` | string | Reviewer's profile photo URL | | `reviewerNumberOfReviews` | number | Optional reviewer review count when Google exposes it | | `reviewerNumberOfPhotos` | number | Optional reviewer photo count when Google exposes it | | `isLocalGuide` | boolean | Optional Local Guide badge flag when available | | `rating` | number | Star rating (1-5) | | `reviewText` | string | Full review text | | `publishedAt` | string | Relative publish date (e.g. "2 months ago") | | `publishedAtTimestamp` | number | Unix timestamp of publication | | `language` | string | Language code of the review | | `visitedDate` | string | Optional visited-date label when Google provides it | | `responseFromOwnerText` | string | Business owner's reply text | | `responseFromOwnerDate` | string | Date the owner replied (YYYY-MM-DD) | | `reviewPhotoUrls` | string\[] | Photos attached to the review | | `reviewId` | string | Unique review identifier | | `reviewUrl` | string | Direct link to the review | | `source` | string | Upstream review source label, when present | ### Tips for Best Results #### Choosing a Sort Order - **Most Relevant** (default): Google's ranking — a mix of recency, helpfulness, and rating - **Newest First**: Best for monitoring recent feedback or tracking trends over time - **Highest/Lowest Rating**: Useful for sentiment analysis or finding specific pain points #### Maximizing Coverage - Set `maxReviewsPerPlace` to `0` to collect up to 50,000 reviews - Use `sortBy: "newest"` with `reviewsStartDate` to collect only recent reviews efficiently - Combine `minReviewRating` and `maxReviewRating` to target specific star levels #### Working with Multiple Places - Mix URLs and search queries in the same run - Each place is processed sequentially with automatic pacing - Failed places are skipped without stopping the run — check the log for details #### Large-Scale Collection - Use **residential proxies** for best success rates on large runs - For places with 10,000+ reviews, consider splitting across multiple runs with different sort orders - Results are pushed to your dataset as they're collected — no need to wait for the full run ### Pricing **$3.00 per 1,000 reviews** — among the lowest prices on Apify for Google Maps review data. | Reviews | Cost | |---------|------| | 100 | $0.30 | | 1,000 | $3.00 | | 10,000 | $30.00 | | 100,000 | $300.00 | Platform fees (compute, proxy, storage) are additional and depend on your Apify plan. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** - Workflow automation - **Google Sheets** - Direct spreadsheet export - **Slack** / **Email** - Notifications on new results - **Webhooks** - Custom API integrations - **Apify API** - Full programmatic access ### Legal & Ethical Use This actor is designed for legitimate reputation monitoring, market research, and competitive intelligence. Users are responsible for complying with applicable laws and Google's Terms of Service. Do not use scraped data for spam, harassment, or any illegal purpose. # Actor input Schema ## `placeUrls` (type: `array`): Google Maps place URLs to scrape reviews from (e.g. 'https://www.google.com/maps/place/...'). You can also paste place IDs like 'ChIJ...' directly. ## `searchQueries` (type: `array`): Search Google Maps to find places, then scrape their reviews. Each query finds one place (e.g. 'Eiffel Tower Paris', 'Central Park New York'). ## `maxReviewsPerPlace` (type: `integer`): Maximum number of reviews to scrape per place. Set to 0 for all reviews. Recommended: 100-1000 to keep costs reasonable. ## `sortBy` (type: `string`): How to sort the reviews before scraping. ## `language` (type: `string`): Language for Google Maps interface and review display. ## `countryCode` (type: `string`): Country context for Google Maps. Helps return relevant results. ## `reviewsStartDate` (type: `string`): Only include reviews published on or after this date (YYYY-MM-DD format, e.g. 2024-01-15). Leave empty for all reviews. ## `minReviewRating` (type: `integer`): Only include reviews with at least this star rating (1-5). ## `maxReviewRating` (type: `integer`): Only include reviews with at most this star rating (1-5). ## `onlyWithText` (type: `boolean`): Skip reviews that only have a star rating without any text. ## `proxyConfiguration` (type: `object`): Configure proxy settings. Residential proxies recommended for best results. ## Actor input object example ```json { "placeUrls": [], "searchQueries": [], "maxReviewsPerPlace": 100, "sortBy": "relevant", "language": "en", "onlyWithText": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `reviews` (type: `string`): Table of scraped reviews with key fields. ## `details` (type: `string`): Detailed review data including photos and owner responses. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "placeUrls": [], "searchQueries": [], "maxReviewsPerPlace": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/google-maps-reviews-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "placeUrls": [], "searchQueries": [], "maxReviewsPerPlace": 100, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("solidcode/google-maps-reviews-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "placeUrls": [], "searchQueries": [], "maxReviewsPerPlace": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call solidcode/google-maps-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/google-maps-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Reviews Scraper | 💰 $0.25 per 1,000 results", "description": "Scrape Google Maps reviews at scale. Extract review text, ratings, reviewer details, owner responses, photos, and more for any place on Google Maps.", "version": "1.0", "x-build-id": "mozELW6XxKNyNQVAV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~google-maps-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~google-maps-reviews-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~google-maps-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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": { "placeUrls": { "title": "Place URLs", "type": "array", "description": "Google Maps place URLs to scrape reviews from (e.g. 'https://www.google.com/maps/place/...'). You can also paste place IDs like 'ChIJ...' directly.", "items": { "type": "string" } }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Search Google Maps to find places, then scrape their reviews. Each query finds one place (e.g. 'Eiffel Tower Paris', 'Central Park New York').", "items": { "type": "string" } }, "maxReviewsPerPlace": { "title": "Max Reviews Per Place", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to scrape per place. Set to 0 for all reviews. Recommended: 100-1000 to keep costs reasonable.", "default": 100 }, "sortBy": { "title": "Sort Reviews By", "enum": [ "relevant", "newest", "highest", "lowest" ], "type": "string", "description": "How to sort the reviews before scraping.", "default": "relevant" }, "language": { "title": "Language", "enum": [ "en", "nl", "de", "fr", "es", "it", "pt", "pl", "cs", "da", "sv", "no", "fi", "el", "tr", "ar", "he", "ja", "ko", "zh-CN", "zh-TW", "th", "vi", "id", "ms", "hi", "ru", "uk", "ro", "hu", "hr", "bg", "sk" ], "type": "string", "description": "Language for Google Maps interface and review display.", "default": "en" }, "countryCode": { "title": "Country", "enum": [ "", "US", "GB", "CA", "AU", "NZ", "NL", "DE", "FR", "ES", "IT", "PT", "BE", "LU", "AT", "CH", "PL", "CZ", "SK", "HU", "RO", "BG", "HR", "GR", "DK", "SE", "NO", "FI", "IE", "TR", "IL", "AE", "SA", "JP", "KR", "CN", "IN", "TH", "SG", "MY", "ID", "PH", "VN", "BR", "MX", "AR", "CO", "CL", "PE", "ZA", "NG", "EG", "KE", "MA", "RU", "UA" ], "type": "string", "description": "Country context for Google Maps. Helps return relevant results." }, "reviewsStartDate": { "title": "Reviews Start Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only include reviews published on or after this date (YYYY-MM-DD format, e.g. 2024-01-15). Leave empty for all reviews." }, "minReviewRating": { "title": "Minimum Review Rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only include reviews with at least this star rating (1-5)." }, "maxReviewRating": { "title": "Maximum Review Rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only include reviews with at most this star rating (1-5)." }, "onlyWithText": { "title": "Only Reviews With Text", "type": "boolean", "description": "Skip reviews that only have a star rating without any text.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxy settings. Residential proxies recommended for best results." } } }, "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 } } } } } } } } } } ```