# Google Reviews Scraper (`godberry/google-reviews-scraper`) Actor Extract reviews from any Google Maps business. Paste a URL, get clean structured review data with ratings, text, dates, reviewer info, and owner responses. - **URL**: https://apify.com/godberry/google-reviews-scraper.md - **Developed by:** [Tomas Lebedinskas](https://apify.com/godberry) (community) - **Categories:** E-commerce, Lead generation, SEO tools - **Stats:** 2 total users, 1 monthly users, 66.7% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.10 / small batch (up to 50 reviews) 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 Reviews Scraper Extract reviews from any Google Maps business in seconds. Paste URLs from your browser — get clean, structured review data ready for analysis, reputation management, or feeding into AI pipelines. ### How to use (30 seconds) 1. Open [Google Maps](https://www.google.com/maps) in your browser 2. Click any business (restaurant, shop, hotel, service, etc.) 3. Copy the URL from the address bar 4. Paste it into `placeUrls` below and click **Start** That's it. You can paste multiple URLs to scrape several places in one run. ### What you get Every review comes back as a structured JSON row with these fields: | Field | Description | | --------------------- | -------------------------------------------------- | | **Review text** | Full review content (auto-expanded) | | **Star rating** | 1-5 stars per review | | **Reviewer name** | Name and profile link | | **Local Guide badge** | Whether reviewer is a Local Guide | | **Review date** | When the review was posted | | **Owner response** | Business owner's reply (if any) | | **Review likes** | How many people found the review helpful | | **Review images** | URLs of photos attached to review | | **Place info** | Name, address, overall rating, total review count | ### Why this scraper - **Fast** — 100 reviews in ~30 seconds. 5 reviews in ~10 seconds. - **Focused** — Reviews only. No bloated place-data fields you'll throw away. - **Flat-fee pricing** — Pay per *place*, not per *review*. Scrape 500 reviews from one place for the same price as 51. - **Handles multiple UI variants** — Restaurants, shops, hotels, markets, department stores. Tested across 9 countries and 3 scripts. - **Flexible input** — Accepts browser-copied URLs, short links, Place IDs, or plain business-name search queries. - **Rich data** — Reviewer name, star rating, full text (auto-expanded), relative date, images, owner responses, Local Guide status, and the place's own metadata on every row. ### Input ```json { "placeUrls": [ "https://www.google.com/maps/place/Katz's+Delicatessen/@40.7223234,-73.9873893", "Lokys restaurant Vilnius", "ChIJm77V--yUC0cRwEg_TQAef9Q" ], "maxReviewsPerPlace": 100, "sortBy": "newest", "onlyWithText": false, "language": "en" } ```` #### Input fields - **placeUrls** (required): Array of Google Maps URLs, short links, Place IDs, or business names - **maxReviewsPerPlace** (default: 100): How many reviews to extract per place (max 5,000) - **sortBy** (default: "newest"): Sort order — `relevant`, `newest`, `highest`, `lowest` - **onlyWithText** (default: false): Skip star-only reviews without text - **language** (default: all): Filter by language code (e.g., `en`, `de`, `fr`) ### Output example ```json { "placeUrl": "https://www.google.com/maps/place/?q=place_id:ChIJm77V--yUC0cRwEg_TQAef9Q&hl=en", "placeName": "McDonald's", "placeAddress": "Václavské nám. 9, 110 00 Nové Město, Czechia", "placeOverallRating": 3.9, "placeTotalReviews": 10262, "reviewerName": "Zoli Szabo", "reviewerUrl": "https://www.google.com/maps/contrib/111004890056055284536/reviews?hl=en", "reviewerTotalReviews": 42, "reviewerIsLocalGuide": true, "reviewRating": 4, "reviewText": "Regular MC Donald's. You pay extra for the toilet, which they reimburse you in the form of a coupon...", "reviewRelativeDate": "2 hours ago", "reviewLikes": 0, "ownerResponse": null, "ownerResponseDate": null, "reviewImages": ["https://lh3.googleusercontent.com/..."], "scrapedAt": "2026-04-13T14:30:00.000Z" } ``` ### Use cases - **Reputation management** — Monitor what customers say about your business - **Competitor analysis** — Compare review sentiment across competitors - **Lead generation** — Find businesses with poor reviews (opportunity for your service) - **Market research** — Analyze customer feedback patterns in any industry - **SEO & local marketing** — Track review velocity and response rates - **Sentiment analysis** — Feed reviews into NLP/AI pipelines ### Pricing Flat fee per place, based on how many reviews you extract from it: | Batch size | Price per place | Per-review cost at max | | ------------------ | --------------- | ------------------------- | | Up to 50 reviews | **$0.10** | $0.002 | | 51 or more reviews | **$0.25** | $0.0005 (at 500 reviews) | **How to think about it:** if you scrape 500 reviews from one restaurant, you pay $0.25. If you scrape 5 reviews, you pay $0.10. We only charge once per place — not once per review — so bigger extractions are dramatically cheaper per row. For comparison: Google's official Places Details API charges ~$17 per 1,000 requests for reviews (and only returns 5 reviews per request). To get 1,000 reviews via the official API you'd pay ~$3.40. This scraper can pull 1,000 reviews for $0.25–$0.50 depending on how they're distributed across places — roughly **7–14× cheaper per review**, and you get the full review text instead of the API's truncated previews. ### Tested locations We regression-test against real Google Maps across: 🇺🇸 USA · 🇬🇧 UK · 🇩🇪 Germany · 🇫🇷 France · 🇮🇹 Italy · 🇪🇸 Spain · 🇯🇵 Japan · 🇦🇺 Australia · 🇷🇺 Russia · 🇨🇿 Czechia · 🇱🇹 Lithuania Business types validated: **restaurants**, **hotels**, **cafés & coffee shops**, **department stores**, **markets & attractions**, **fine-dining**, **niche independents**, **global chains with 100K+ reviews**. ### Supported input formats - ✅ Full Google Maps URL: `https://www.google.com/maps/place/...` - ✅ Short link: `https://maps.app.goo.gl/abc123` - ✅ Place ID: `ChIJLU7jZClu5kcR4PcOOO6p3I0` - ✅ CID: `1234567890123456789` - ✅ Business name search: `"Starbucks Times Square New York"` ### Limitations & known edge cases - **5,000 reviews per place is Google's display ceiling.** Even places with 200K reviews only expose ~5K through the Maps UI. This scraper respects that. - **Landmarks without a Reviews tab** (e.g. Eiffel Tower, monuments, some parks) show reviews inline on their Overview page. These may not extract reliably — use the specific business inside the landmark instead (e.g. a restaurant, shop, or entry ticket office). - **Ambiguous URLs fail fast** with a clear error. If you hand-type `/maps/place/McDonald's/@coords` without Google's internal data hash, Google can't resolve it to a specific place and the run aborts with an actionable message. Always copy URLs directly from your browser's address bar. - **Very popular places (100K+ reviews)** may take several minutes — we have to scroll through Google's virtualized list, which throttles itself. - **Relative dates only.** The `reviewRelativeDate` field returns Google's original "2 months ago" / "a week ago" string rather than an absolute date, because Google doesn't expose the absolute timestamp in the rendered DOM. - **Review text is extracted in whatever language Google renders it in** (controlled by the `language` input field). For mixed-locale reviews, pass `language: "en"` to get English translations where Google provides them. ### Troubleshooting | Problem | Cause | Fix | | ------- | ----- | --- | | Run fails with "URL could not be resolved" | URL doesn't match a specific place | Open Google Maps, click the place, copy the URL directly | | Empty dataset | Place is a landmark without a Reviews tab | Try a specific business inside the landmark | | First run is slower than expected | Playwright browser is warming up | Subsequent runs in the same session are ~2× faster | | Missing owner responses | Place has no owner responses | Not a bug — the field is `null` when no response exists | ### Support Found a place that doesn't scrape correctly? Hit a bug? Open an issue on the actor's Apify page with: 1. The input URL you used 2. The error message (if any) 3. What you expected to get I typically respond within 24 hours. # Actor input Schema ## `placeUrls` (type: `array`): One per line. The easiest way: open Google Maps in your browser, click a business, and copy the URL from the address bar. Also accepts: short links (maps.app.goo.gl/...), Place IDs (ChIJ...), or a search query like 'McDonald's Wenceslas Square Prague'. Tip: landmarks like the Eiffel Tower don't have a dedicated Reviews tab on Google Maps — use business URLs (restaurants, hotels, shops). ## `maxReviewsPerPlace` (type: `integer`): Maximum number of reviews to extract per place. Higher = longer run time. ## `sortBy` (type: `string`): How to sort the reviews before extracting. ## `onlyWithText` (type: `boolean`): Skip star-only reviews that don't have any text content. ## `language` (type: `string`): Language code (e.g., 'en', 'de', 'lt') to filter reviews. Leave empty for all languages. ## Actor input object example ```json { "placeUrls": [ "https://www.google.com/maps/place/McDonald's/@50.0834147,14.4251933,17z", "ChIJm77V--yUC0cRwEg_TQAef9Q", "Starbucks Reserve Roastery New York" ], "maxReviewsPerPlace": 100, "sortBy": "newest", "onlyWithText": false, "language": "" } ``` # 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": [ "https://www.google.com/maps/search/McDonalds+Wenceslas+Square+Prague/" ] }; // Run the Actor and wait for it to finish const run = await client.actor("godberry/google-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": ["https://www.google.com/maps/search/McDonalds+Wenceslas+Square+Prague/"] } # Run the Actor and wait for it to finish run = client.actor("godberry/google-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": [ "https://www.google.com/maps/search/McDonalds+Wenceslas+Square+Prague/" ] }' | apify call godberry/google-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=godberry/google-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Reviews Scraper", "description": "Extract reviews from any Google Maps business. Paste a URL, get clean structured review data with ratings, text, dates, reviewer info, and owner responses.", "version": "0.1", "x-build-id": "ld0DzxyR9epBwXpxF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/godberry~google-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-godberry-google-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/godberry~google-reviews-scraper/runs": { "post": { "operationId": "runs-sync-godberry-google-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/godberry~google-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-godberry-google-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", "required": [ "placeUrls" ], "properties": { "placeUrls": { "title": "Google Maps URLs, Place IDs, or business searches", "type": "array", "description": "One per line. The easiest way: open Google Maps in your browser, click a business, and copy the URL from the address bar. Also accepts: short links (maps.app.goo.gl/...), Place IDs (ChIJ...), or a search query like 'McDonald's Wenceslas Square Prague'. Tip: landmarks like the Eiffel Tower don't have a dedicated Reviews tab on Google Maps — use business URLs (restaurants, hotels, shops).", "items": { "type": "string" } }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of reviews to extract per place. Higher = longer run time.", "default": 100 }, "sortBy": { "title": "Sort reviews by", "enum": [ "relevant", "newest", "highest", "lowest" ], "type": "string", "description": "How to sort the reviews before extracting.", "default": "newest" }, "onlyWithText": { "title": "Only reviews with text", "type": "boolean", "description": "Skip star-only reviews that don't have any text content.", "default": false }, "language": { "title": "Language filter", "type": "string", "description": "Language code (e.g., 'en', 'de', 'lt') to filter reviews. Leave empty for all languages.", "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 } } } } } } } } } } ```