# Google Maps Reviews Scraper (`arpitgandhi1934/google-maps-reviews`) Actor Paste a Google Maps place link, get all its reviews — reviewer, star rating, date, full text, and owner responses. - **URL**: https://apify.com/arpitgandhi1934/google-maps-reviews.md - **Developed by:** [Arpit Gandhi](https://apify.com/arpitgandhi1934) (community) - **Categories:** Lead generation, SEO tools, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.03 / 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 Paste a Google Maps place link and get back that place's reviews — every reviewer, star rating, date, full review text, and even the business's replies. Point it at one place or many, cap the count or pull **all** of them. There's nothing to set up or configure — just give it a place URL and it returns the reviews, whether you want the latest handful or the entire history. > ⚡ **You only need one thing: the place's Google Maps URL** — the full link from your browser's address bar that starts with `https://www.google.com/maps/place/…`. **Not sure how to get it?** See **[How to get a Google Maps place URL](#how-to-get-a-google-maps-place-url)** right below. 👇 **Who it's for:** - 📊 **Reputation monitoring** — track what customers are saying about your locations over time - 💬 **Sentiment analysis** — feed real review text into your NLP / AI pipeline - 🔍 **Competitor review mining** — see exactly why customers love (or leave) a rival - 🎯 **Lead research** — qualify businesses by rating volume, recency, and response behavior --- ### How to get a Google Maps place URL This is the #1 question, so here's the exact, foolproof way. The actor needs the **full place URL** (the one that starts with `https://www.google.com/maps/place/...`). #### 💻 Desktop (recommended — gives the exact URL the actor needs) 1. Go to **[google.com/maps](https://www.google.com/maps)**. 2. **Search** for the business or place, then **click its pin on the map** — or click its **name** in the results list. 3. When the place's panel opens on the left, look at your browser's **address bar**. The URL now starts with: `https://www.google.com/maps/place//@,,17z/data=...` 4. **Select the whole address-bar URL and copy it.** Paste that into the actor's **"📍 Google Maps place link(s)"** field. > ⚠️ **Important:** The blue **"Share"** button's **"Copy link"** gives a **shortened** link (like `https://maps.app.goo.gl/...`). **Prefer the full address-bar URL** (`https://www.google.com/maps/place/...`) — that's the format the actor expects. #### 📱 Mobile 1. Open the place in the Google Maps app. 2. Tap **Share → Copy link**. 3. Then **open that link in a desktop browser** and copy the **expanded** address-bar URL — the one that contains `/maps/place/`. Paste *that* into the actor. #### ✅ Example of a good URL ```` https://www.google.com/maps/place/Flos+Music+%26+Bar/@28.7067705,77.1839605,17z/data=!4m6!3m5!1s0x390d03c87620376d:0x7ec0084cad8ed5df!8m2!3d28.7067705!4d77.1839605!16s%2Fg%2F11vq3fmm9d ```` --- ### What you get One dataset item **per review**, with: - 🏷️ **placeName** — the business / place name - 🔗 **placeUrl** — the place URL you supplied - 🆔 **fid** — Google's stable place feature ID - 👤 **reviewer** — the reviewer's name - ⭐ **rating** — star rating, 1–5 (every review has one) - 📅 **date** — when it was posted, relative (e.g. `"3 months ago"`) — present on every review - 📝 **text** — the written review body (present when the reviewer wrote text; some reviews are rating-only) - 🧭 **reviewerInfo** — the reviewer's badge / activity, e.g. `"Local Guide · 58 reviews"` - 🔗 **reviewerUrl** — link to the reviewer's Google profile - 🆔 **reviewId** — Google's unique ID for the review - 👍 **likes** — how many people found the review helpful - 💬 **ownerResponse** — the business's reply to the review, if there is one - ⏱️ **scrapedAt** — timestamp of the run --- ### Input | Field | Key | Type | Default | Description | |---|---|---|---|---| | 📍 Google Maps place link(s) | `startUrls` | array of URLs | — (**required**) | One or more Google Maps place URLs (`https://www.google.com/maps/place/...`). Add as many places as you like. | | ⭐ Max reviews per place | `maxReviews` | integer | `0` | How many reviews to pull per place. **`0` = ALL reviews** (complete, but slower on very large places). Set a number to cap and finish fast — the run stops the instant it hits your target. | | Proxy | `proxyConfiguration` | proxy | Apify Residential | **Residential proxy strongly recommended** — clean IPs give the most reliable access to Google. | #### Example input ```json { "startUrls": [ { "url": "https://www.google.com/maps/place/Flos+Music+%26+Bar/@28.7067705,77.1839605,17z/data=!4m6!3m5!1s0x390d03c87620376d:0x7ec0084cad8ed5df!8m2!3d28.7067705!4d77.1839605!16s%2Fg%2F11vq3fmm9d" } ], "maxReviews": 200, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` *** ### Output Each item in the dataset is a single review. Here's a realistic example: ```json { "placeName": "Flos Music & Bar", "placeUrl": "https://www.google.com/maps/place/Flos+Music+%26+Bar/@28.7067705,77.1839605,17z/data=...", "fid": "0x390d03c87620376d:0x7ec0084cad8ed5df", "reviewer": "Priya Sharma", "rating": 5, "date": "3 months ago", "text": "Amazing vibe and live music every weekend. The cocktails were excellent and the staff went out of their way to get us a good table. Will definitely come back.", "reviewerInfo": "Local Guide · 58 reviews", "reviewerUrl": "https://www.google.com/maps/contrib/103482759812345678901/reviews", "reviewId": "ChdDSUhNMG9nS0VJQ0FnSUNfeXZ1cnJnRRAB", "likes": 4, "ownerResponse": "Thank you so much for the kind words, Priya! We can't wait to host you again. 🎶", "scrapedAt": "2026-07-08T15:42:11.302Z" } ``` #### Output fields | Field | Type | Description | |---|---|---| | `placeName` | string | The business / place name. | | `placeUrl` | string | The place URL you supplied. | | `fid` | string | Google's stable place feature ID (identifies the place across links). | | `reviewer` | string | The reviewer's display name. | | `rating` | number | Star rating, 1–5. Present on every review. | | `date` | string | Relative post date, e.g. `"3 months ago"`. Present on every review. | | `text` | string | null | The written review body. Present when the reviewer wrote text; `null` for rating-only reviews. | | `reviewerInfo` | string | null | Reviewer badge / activity, e.g. `"Local Guide · 58 reviews"`. | | `reviewerUrl` | string | null | Link to the reviewer's Google profile. | | `reviewId` | string | null | Google's unique ID for the review. | | `likes` | number | How many people marked the review helpful (`0` if none). | | `ownerResponse` | string | null | The business's reply to the review, if there is one. | | `scrapedAt` | string | ISO timestamp of when the run scraped this review. | *** ### Speed & completeness The actor returns the **complete review list** for a place — not just the handful shown by default. - **Set `maxReviews` to a number** and the run finishes fast: it stops the instant it reaches your target. Great when you only need, say, the latest 100 or 500. - **Leave `maxReviews` at `0` (all)** and it returns every review. This is complete, but on places with **thousands** of reviews it can take **several minutes** to work through the full list — that's expected for very large places. **Rule of thumb:** if you need everything, use `0` and let it run. If you need speed, set a cap. *** ### FAQ **Does it get ALL reviews?** Yes. Set `maxReviews` to `0` (the default) and it loads the place's entire review list. Set a number to cap it instead. **How long does a big place take?** Small and mid-size places finish quickly. A place with thousands of reviews pulled with `maxReviews: 0` can take several minutes to work through the full list. Capping `maxReviews` keeps runs fast. **Can I scrape multiple places at once?** Yes — add multiple URLs to `startUrls` and the actor processes each place and outputs reviews for all of them into the same dataset (each review carries its own `placeName` / `placeUrl` / `fid`). **Do I need a proxy?** Yes — a **residential** proxy is strongly recommended. Clean IPs give the most reliable access to Google, and residential IPs work best. Apify Residential proxy is preselected by default. **What export formats are available?** All of Apify's standard exports — **JSON, CSV, and Excel** (plus HTML, XML, RSS) — from the run's dataset via the Apify Console or API. **What if a review has no text?** You still get it. Every review includes a `rating` and `date`; `text` is filled in only when the reviewer actually wrote something (rating-only reviews come back with `text: null`). # Actor input Schema ## `startUrls` (type: `array`): Paste the FULL Google Maps place link — the one from your browser's ADDRESS BAR that starts with https://www.google.com/maps/place/… How to get it: open google.com/maps → search the place → click its pin/name → copy the whole URL from the address bar. ⚠️ The blue 'Share → Copy link' button gives a SHORT link (maps.app.goo.gl/…) — use the full address-bar URL instead. Example: https://www.google.com/maps/place/Flos+Music+%26+Bar/@28.7067705,77.1839605,17z/data=!4m6!3m5!1s0x390d03c87620376d:0x7ec0084cad8ed5df!8m2!3d28.7067705!4d77.1839605!16s%2Fg%2F11vq3fmm9d ## `maxReviews` (type: `integer`): How many reviews per place. 0 = ALL (complete, but slower on very large places). Set a number to cap and finish fast — it stops the instant it hits your target. ## `proxyConfiguration` (type: `object`): Residential proxy strongly recommended — clean IPs give the most reliable access to Google. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.google.com/maps/place/Flos+Music+%26+Bar/@28.7067705,77.1839605,17z/data=!4m6!3m5!1s0x390d03c87620376d:0x7ec0084cad8ed5df!8m2!3d28.7067705!4d77.1839605!16s%2Fg%2F11vq3fmm9d" } ], "maxReviews": 0, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "startUrls": [ { "url": "https://www.google.com/maps/place/Flos+Music+%26+Bar/@28.7067705,77.1839605,17z/data=!4m6!3m5!1s0x390d03c87620376d:0x7ec0084cad8ed5df!8m2!3d28.7067705!4d77.1839605!16s%2Fg%2F11vq3fmm9d" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("arpitgandhi1934/google-maps-reviews").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 = { "startUrls": [{ "url": "https://www.google.com/maps/place/Flos+Music+%26+Bar/@28.7067705,77.1839605,17z/data=!4m6!3m5!1s0x390d03c87620376d:0x7ec0084cad8ed5df!8m2!3d28.7067705!4d77.1839605!16s%2Fg%2F11vq3fmm9d" }] } # Run the Actor and wait for it to finish run = client.actor("arpitgandhi1934/google-maps-reviews").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 '{ "startUrls": [ { "url": "https://www.google.com/maps/place/Flos+Music+%26+Bar/@28.7067705,77.1839605,17z/data=!4m6!3m5!1s0x390d03c87620376d:0x7ec0084cad8ed5df!8m2!3d28.7067705!4d77.1839605!16s%2Fg%2F11vq3fmm9d" } ] }' | apify call arpitgandhi1934/google-maps-reviews --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=arpitgandhi1934/google-maps-reviews", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Reviews Scraper", "description": "Paste a Google Maps place link, get all its reviews — reviewer, star rating, date, full text, and owner responses.", "version": "1.0", "x-build-id": "wJwPQDGR8ijKbJLsB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arpitgandhi1934~google-maps-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arpitgandhi1934-google-maps-reviews", "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/arpitgandhi1934~google-maps-reviews/runs": { "post": { "operationId": "runs-sync-arpitgandhi1934-google-maps-reviews", "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/arpitgandhi1934~google-maps-reviews/run-sync": { "post": { "operationId": "run-sync-arpitgandhi1934-google-maps-reviews", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "📍 Google Maps place link(s)", "type": "array", "description": "Paste the FULL Google Maps place link — the one from your browser's ADDRESS BAR that starts with https://www.google.com/maps/place/…\n\nHow to get it: open google.com/maps → search the place → click its pin/name → copy the whole URL from the address bar.\n\n⚠️ The blue 'Share → Copy link' button gives a SHORT link (maps.app.goo.gl/…) — use the full address-bar URL instead.\n\nExample: https://www.google.com/maps/place/Flos+Music+%26+Bar/@28.7067705,77.1839605,17z/data=!4m6!3m5!1s0x390d03c87620376d:0x7ec0084cad8ed5df!8m2!3d28.7067705!4d77.1839605!16s%2Fg%2F11vq3fmm9d", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviews": { "title": "⭐ Max reviews per place", "minimum": 0, "type": "integer", "description": "How many reviews per place. 0 = ALL (complete, but slower on very large places). Set a number to cap and finish fast — it stops the instant it hits your target.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxy strongly recommended — clean IPs give the most reliable access to Google.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```