# $0.29 Comprehensive Google Maps Reviews Scraper (`blueorion/comprehensive-google-maps-reviews-scraper`) Actor $0.29 per 1000 reviews Offer ends soon. Scrape reviews from Google Maps using URLs, FIDs, CIDs, or Place IDs. Supports sorting, aggressive or slow scraping modes, and extracts full review details, ratings, images, metadata, and contact info. Perfect for analysis, monitoring, or competitive research. - **URL**: https://apify.com/blueorion/comprehensive-google-maps-reviews-scraper.md - **Developed by:** [Blue Orion](https://apify.com/blueorion) (community) - **Categories:** E-commerce, Developer tools, Agents - **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Deep Review Insights from Any Location Unlock powerful business intelligence by scraping real-time reviews from Google Maps using URLs, FIDs, CIDs, or Place IDs. Whether you're analyzing hotel feedback, restaurant performance, or customer sentiment for retail chains, this actor gives you full control over how you extract and organize review data. --- ### πŸš€ What This Actor Can Do βœ… Extract up to **10,000 reviews per location** βœ… Scrape by: - Google Maps URLs - FIDs (Feature IDs) - CIDs (Customer IDs) - Place IDs from Google Places API or network tools βœ… Collect: - Review text, star ratings - Reviewer names, images, profiles - Timestamps, languages - Owner responses - Review images and metadata βœ… Automatically extract: - Address, coordinates - Category, hotel star rating - Website, phone number - Plus Code and more βœ… Choose review sorting and language βœ… Toggle between **aggressive** and **slow** scraping modes --- ### 🧾 Input Options | Field | Description | |---------------|-------------| | `startUrls` | Google Maps place URLs to scrape from | | `FIDs` | Google Maps Feature IDs (e.g., `0x884d0d95b0b19295:0xc0bf006c6a5a17d3`) | | `CIDs` | Google Customer IDs (e.g.,`13888820241474656211`) | | `PlaceIds` | Google Place IDs (e.g., `ChIJlZKxsJUNTYgR0xdaamwAv8A`) | | `maxReviews` | Max reviews per place (10–10,000, default: 100) | | `reviewsSort` | Sort method: `newest`, `mostRelevant`, `highestRanking`, `lowestRanking` | | `mode` | `aggressive` (fast, proxy recommended) or `slow` (human-like) | --- ### πŸ“€ Example Output ```json { "reviewId": "ChZDSUhNMG9nS0VJQ0FnTUNJdjZPdFdBEAE", "reviewUrl": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnTUNJdjZPdFdBEAE!2m1!1s0x0:0xc0bf006c6a5a17d3!3m1!1s2@1:CIHM0ogKEICAgMCIv6OtWA%7CCgwIwd_GvwYQoKOO5AI%7C?hl=en", "reviewerName": "eva kallo", "reviewerPhotoUrl": "https://lh3.googleusercontent.com/a/ACg8ocKCRuHyy2ztwVW_bmapB0dO11aRVEIQbOmW_Rhc2ObxM3lBfg=s120-c-rp-mo-ba3-br100", "reviewerUrl": "https://www.google.com/maps/contrib/114337673017500467763?hl=en", "reviewerId": "114337673017500467763", "reviewerNumberOfReviews": 45, "reviewOrigin": "Google", "text": "Excellent location just steps from the city market. Easy short walk to Roanoke Hotel. Rooms are on floors 7-9, lower levels being a parking garage. Comfortable mattress. Wish windows could be opened. Nice breakfast.", "textTranslated": null, "reviewContext": { "Rooms": 5, "Service": 5, "Location": 5 }, "publishedAtDate": "2025-04-05T22:33:37.746Z", "lastEditedAtDate": "2025-04-05T22:33:37.746Z", "publishedAtDateTimestamp": 1743892417746820, "lastEditedAtDateTimestamp": 1743892417746820, "publishAt": "2 months ago", "responseFromOwnerDate": "2025-04-07T20:43:23.000Z", "responseFromOwnerDateTimestamp": 1744058603000000, "responseFromOwnerText": "Thank you so much for staying with us! It was a pleasure having you and we are happy to see your 5 star review. We hope you stay with us at Hampton Inn & Suites Roanoke-Downtown next time you're visiting Roanoke.", "originalLanguage": "en", "translatedLanguage": null, "language": "en", "reviewImageUrls": null, "stars": 5, "cid": "13888820241474656211", "fid": "0x884d0d95b0b19295:0xc0bf006c6a5a17d3", "url": "https://www.google.com/maps/place/Hampton+Inn+%26+Suites+Roanoke-Downtown/@37.2687369,-79.9391535,14.73z/data=!4m9!3m8!1s0x884d0d95b0b19295:0xc0bf006c6a5a17d3!5m2!4m1!1i2!8m2!3d37.270292!4d-79.9395061!16s%2Fg%2F11bzs4br2k?entry=tts&g_ep=EgoyMDI1MDYyMy4yIPu8ASoASAFQAw%3D%3D&skid=f33f2608-2d76-4e9b-8cdb-bfe582c81cac", "location": { "lat": 37.2687369, "lng": -79.9391535 }, "title": "Hampton Inn & Suites Roanoke-Downtown", "address": "Hampton Inn & Suites Roanoke-Downtown Β· 27 Church Ave SE, Roanoke, VA 24011, United States", "totalScore": 4.3, "reviewsCount": 926, "placeId": "ChIJlZKxsJUNTYgR0xdaamwAv8A", "imageUrl": "https://lh3.googleusercontent.com/a-/ALV-UjXAjvY7X-eJnTJUWHeGp1m2GX_lMZW-0nRox8I0kxH1RCmZkgJH=w36-h36-p-rp-mo-ba3-br100", "category": "Hotel", "website": "hilton.com", "phoneNumber": "+1 540-400-6000", "hotelStar": "2-star hotel", "plusCode": "73C6+45 Roanoke, Virginia, USA", "scrapedAt": "2025-06-30T04:43:02.780Z" } # Actor input Schema ## `startUrls` (type: `array`): List of Google Maps URLs to extract reviews from. ## `FIDs` (type: `array`): List of Google Maps Feature IDs (FID) to extract reviews from. ## `CIDs` (type: `array`): List of Google Maps CID (customer ID) values. ## `PlaceIds` (type: `array`): List of Google Place IDs (from Places API or network capture). ## `maxReviews` (type: `integer`): The maximum number of reviews to extract per place input (between 10 and 10,000). ## `reviewsSort` (type: `string`): How to sort the reviews before scraping. ## `mode` (type: `string`): Choose how aggressively to scrape Google Maps Reviews. Aggressive mode is faster but may trigger blocks; slow mimics human behavior. ## Actor input object example ```json { "startUrls": [ { "url": "https://maps.app.goo.gl/BQNVgPnuDww7F7aRA" }, { "url": "https://www.google.com/maps/place/Hampton+Inn+%26+Suites+Roanoke-Downtown/@37.2687369,-79.9391535,14.73z/data=!4m9!3m8!1s0x884d0d95b0b19295:0xc0bf006c6a5a17d3!5m2!4m1!1i2!8m2!3d37.270292!4d-79.9395061!16s%2Fg%2F11bzs4br2k?entry=tts&g_ep=EgoyMDI1MDYyMy4yIPu8ASoASAFQAw%3D%3D&skid=f33f2608-2d76-4e9b-8cdb-bfe582c81cac" } ], "FIDs": [ "0x89c25966dcad44b7:0x5cb022a289de6b19", "0x884d0dbf157cd65f:0x5630f57d22fcf53f" ], "CIDs": [ "15792901685599310349", "16906389583988522837" ], "PlaceIds": [ "ChIJ_eznr00MTYgRfQsuJnMnrJA", "ChIJ3W6-1JQNTYgR88bV-bmaQsQ" ], "maxReviews": 10, "reviewsSort": "newest", "mode": "aggressive" } ```` # 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://maps.app.goo.gl/BQNVgPnuDww7F7aRA" }, { "url": "https://www.google.com/maps/place/Hampton+Inn+%26+Suites+Roanoke-Downtown/@37.2687369,-79.9391535,14.73z/data=!4m9!3m8!1s0x884d0d95b0b19295:0xc0bf006c6a5a17d3!5m2!4m1!1i2!8m2!3d37.270292!4d-79.9395061!16s%2Fg%2F11bzs4br2k?entry=tts&g_ep=EgoyMDI1MDYyMy4yIPu8ASoASAFQAw%3D%3D&skid=f33f2608-2d76-4e9b-8cdb-bfe582c81cac" } ], "FIDs": [ "0x89c25966dcad44b7:0x5cb022a289de6b19", "0x884d0dbf157cd65f:0x5630f57d22fcf53f" ], "CIDs": [ "15792901685599310349", "16906389583988522837" ], "PlaceIds": [ "ChIJ_eznr00MTYgRfQsuJnMnrJA", "ChIJ3W6-1JQNTYgR88bV-bmaQsQ" ] }; // Run the Actor and wait for it to finish const run = await client.actor("blueorion/comprehensive-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 = { "startUrls": [ { "url": "https://maps.app.goo.gl/BQNVgPnuDww7F7aRA" }, { "url": "https://www.google.com/maps/place/Hampton+Inn+%26+Suites+Roanoke-Downtown/@37.2687369,-79.9391535,14.73z/data=!4m9!3m8!1s0x884d0d95b0b19295:0xc0bf006c6a5a17d3!5m2!4m1!1i2!8m2!3d37.270292!4d-79.9395061!16s%2Fg%2F11bzs4br2k?entry=tts&g_ep=EgoyMDI1MDYyMy4yIPu8ASoASAFQAw%3D%3D&skid=f33f2608-2d76-4e9b-8cdb-bfe582c81cac" }, ], "FIDs": [ "0x89c25966dcad44b7:0x5cb022a289de6b19", "0x884d0dbf157cd65f:0x5630f57d22fcf53f", ], "CIDs": [ "15792901685599310349", "16906389583988522837", ], "PlaceIds": [ "ChIJ_eznr00MTYgRfQsuJnMnrJA", "ChIJ3W6-1JQNTYgR88bV-bmaQsQ", ], } # Run the Actor and wait for it to finish run = client.actor("blueorion/comprehensive-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 '{ "startUrls": [ { "url": "https://maps.app.goo.gl/BQNVgPnuDww7F7aRA" }, { "url": "https://www.google.com/maps/place/Hampton+Inn+%26+Suites+Roanoke-Downtown/@37.2687369,-79.9391535,14.73z/data=!4m9!3m8!1s0x884d0d95b0b19295:0xc0bf006c6a5a17d3!5m2!4m1!1i2!8m2!3d37.270292!4d-79.9395061!16s%2Fg%2F11bzs4br2k?entry=tts&g_ep=EgoyMDI1MDYyMy4yIPu8ASoASAFQAw%3D%3D&skid=f33f2608-2d76-4e9b-8cdb-bfe582c81cac" } ], "FIDs": [ "0x89c25966dcad44b7:0x5cb022a289de6b19", "0x884d0dbf157cd65f:0x5630f57d22fcf53f" ], "CIDs": [ "15792901685599310349", "16906389583988522837" ], "PlaceIds": [ "ChIJ_eznr00MTYgRfQsuJnMnrJA", "ChIJ3W6-1JQNTYgR88bV-bmaQsQ" ] }' | apify call blueorion/comprehensive-google-maps-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=blueorion/comprehensive-google-maps-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "$0.29 Comprehensive Google Maps Reviews Scraper", "description": "$0.29 per 1000 reviews Offer ends soon. Scrape reviews from Google Maps using URLs, FIDs, CIDs, or Place IDs. Supports sorting, aggressive or slow scraping modes, and extracts full review details, ratings, images, metadata, and contact info. Perfect for analysis, monitoring, or competitive research.", "version": "0.0", "x-build-id": "mleloNhaM6MpVSI3N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blueorion~comprehensive-google-maps-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blueorion-comprehensive-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/blueorion~comprehensive-google-maps-reviews-scraper/runs": { "post": { "operationId": "runs-sync-blueorion-comprehensive-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/blueorion~comprehensive-google-maps-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-blueorion-comprehensive-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": "Start URLs", "type": "array", "description": "List of Google Maps URLs to extract reviews from.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "FIDs": { "title": "FIDs", "type": "array", "description": "List of Google Maps Feature IDs (FID) to extract reviews from.", "items": { "type": "string" } }, "CIDs": { "title": "CIDs", "type": "array", "description": "List of Google Maps CID (customer ID) values.", "items": { "type": "string" } }, "PlaceIds": { "title": "Place IDs", "type": "array", "description": "List of Google Place IDs (from Places API or network capture).", "items": { "type": "string" } }, "maxReviews": { "title": "Maximum Number of Reviews to scrape", "minimum": 10, "maximum": 10000, "type": "integer", "description": "The maximum number of reviews to extract per place input (between 10 and 10,000).", "default": 10 }, "reviewsSort": { "title": "Review Sorting", "enum": [ "newest", "mostRelevant", "highestRanking", "lowestRanking" ], "type": "string", "description": "How to sort the reviews before scraping.", "default": "newest" }, "mode": { "title": "Scraping Mode", "enum": [ "aggressive", "slow" ], "type": "string", "description": "Choose how aggressively to scrape Google Maps Reviews. Aggressive mode is faster but may trigger blocks; slow mimics human behavior.", "default": "aggressive" } } }, "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 } } } } } } } } } } ```