# Maps Reviews Fast (`knowten/maps-reviews-fast`) Actor Extract Google Maps reviews at scale affordably ($0.25/1k). Get texts, stars, reviewer data, translations, owner responses, and photos. Features a unique "Deep Search" mode to bypass Google's pagination limits and scrape the absolute maximum number of reviews per place. - **URL**: https://apify.com/knowten/maps-reviews-fast.md - **Developed by:** [Knowten](https://apify.com/knowten) (community) - **Categories:** E-commerce, AI, Automation - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## 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 Review Scraper πŸ“β­ Extract detailed, accurate, and large-scale reviews from Google Maps in seconds. Whether you're tracking brand sentiment, monitoring competitors, or analyzing local business feedback, **Google Maps Review Scraper** empowers you to collect all the data you need reliably and affordably. --- ### πŸš€ Why this scraper? Unlike other solutions that hit hard limits or charge exorbitant fees, our scraper is optimized for maximum extraction and affordability: * **Cost-Effective**: Only **$0.25 per 1,000 reviews**. Highly competitive pricing compared to other APIs. * **Deep Search Feature**: Google heavily limits review pagination (usually capping at around 3,000 - 4,000 reviews for standard queries). By enabling our **Deep Search** feature, the scraper uses an advanced multi-sort rotation algorithm to bypass these limits and extract the maximum possible amount of reviews for huge places. * **Optimal Defaults**: For the absolute best standalone performance without Deep Search, stick to the **Newest** sorting method (which consistently extracts up to ~5k reviews alone). Selecting other sorting modes might yield fewer results natively due to Google's internal algorithm constraints. * **Unmatched Details**: We extract everything: Review text, translations, reviewer's local guide status, detailed star ratings, photos with GPS coordinates, owner responses, and more. --- ### πŸ“Š What data do you get? Each extracted review is packed with data, including: * πŸ“ **Review text** (Original and Translated) * πŸ“… **Published date** & exact timestamps * 🌟 **Stars & Rating** * πŸ†” **Review ID & direct URL** * βœ… **Response from the owner** (Text and date) * πŸ“· **List of review images** (Includes URLs, dimensions, and locations) * πŸ’¬ **Review context & Survey Data** (Details about the visit, service, and atmosphere) * πŸ§› **Reviewer’s Details** (Name, ID, Profile URL, Photo) * ✍️ **Reviewer’s number of previous reviews** * πŸ‘‹ **Local guide status** --- ### πŸ› οΈ How to scrape Google Reviews Using Google Maps Review Scraper is incredibly simple. Just follow these steps: 1. Add one or more **Google Maps Place URLs** into the input field. 2. Set the **Max Reviews** limit (use `10000000` to extract everything). 3. Choose your **Sort Method** (we highly recommend keeping it as *Newest*). 4. **Enable Deep Search** if you are scraping massive locations with thousands of reviews to ensure you bypass Google's pagination limits. 5. Click the β€œStart” button. 6. Once finished, download your data in **JSON, XML, CSV, Excel, or HTML**. --- ### βš™οΈ Input Configuration | Field | Type | Description | Default | | ----- | ---- | ----------- | ------- | | `startUrls` | Array | List of Google Maps URLs (Place URLs, Search URLs, or Review detail URLs). | `[]` | | `maxReviews` | Integer | Maximum number of reviews to extract per place. Set to a very high number to extract all possible reviews. | `10000000` | | `reviewsSort` | String | Initial sorting method. (e.g., `newest`, `highestRanking`). **Note:** We recommend `newest` for maximum yield. | `"newest"` | | `deepSearch` | Boolean | **Highly Recommended for large places**. Automatically falls back to multiple sorting methods to bypass Google's ~3k review limit. | `false` | | `language` | String | Target language for the translated text. Leave empty (Auto) to use the default. | `""` (Auto) | | `reviewsOrigin` | String | Specify which review sources to scrape (All reviews vs. Google-native reviews). | `"all"` | | `personalData` | Boolean | Include reviewer personal data such as name, profile URL, and photo. | `true` | --- ### πŸ’‘ Use Cases So what can you do with the Google Maps data you collect? Here are just some ideas: * **Customer sentiment analysis:** Identify what people like or dislike about a business, brand, or location. * **Competitive intelligence:** Compare competitors’ strengths and weaknesses. * **Market research:** Discover customer expectations, trends, and needs in specific industries or locations. * **Lead generation:** Find potential business opportunities. * **Reputation management:** Monitor and respond to reviews efficiently. * **Content generation:** Extract authentic customer quotes or testimonials for marketing materials. --- ### πŸ’° Pricing & Performance * **Cost:** ~$0.25 per 1,000 reviews extracted. * **Performance:** Lightweight, HTTP-only scraper. Memory stays constant regardless of the number of reviews extracted, ensuring extreme speed and efficiency without the overhead of heavy browsers. With the Apify Free plan, you get $5 of free usage credits every month, allowing you to extract tens of thousands of reviews completely free of charge! # Actor input Schema ## `startUrls` (type: `array`): Google Maps search, place, review detail, or cid URLs. ## `placeIds` (type: `array`): Google Maps Place IDs. ## `maxReviews` (type: `integer`): Maximum number of reviews per place. Remove or set a very high value to scrape all available reviews. ## `reviewsSort` (type: `string`): Define how reviews should be sorted. ## `deepSearch` (type: `boolean`): If enabled, when the primary sort limit is reached, the scraper will automatically fallback to other sorting methods to bypass Google's ~3,000 review limit and extract maximum possible reviews. ## `reviewsStartDate` (type: `string`): Absolute date like 2024-05-03 or relative date like 8 days, 3 months, 3 hours. ## `language` (type: `string`): Target language for translated reviews (e.g., 'en', 'es'). If left empty, Google will use its default. ## `reviewsOrigin` (type: `string`): Select whether to scrape all reviews or only Google-native reviews when Google exposes this distinction. ## `personalData` (type: `boolean`): Include reviewer personal data such as name, profile URL, and photo. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.google.com/maps/place/Yellowstone+National+Park/@44.5857951,-110.5140571,9z/data=!3m1!4b1!4m5!3m4!1s0x5351e55555555555:0xaca8f930348fe1bb!8m2!3d44.427963!4d-110.588455?hl=en-GB" } ], "maxReviews": 10000000, "reviewsSort": "newest", "deepSearch": false, "reviewsOrigin": "all", "personalData": true } ```` # Actor output Schema ## `results` (type: `string`): No description # 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/Yellowstone+National+Park/@44.5857951,-110.5140571,9z/data=!3m1!4b1!4m5!3m4!1s0x5351e55555555555:0xaca8f930348fe1bb!8m2!3d44.427963!4d-110.588455?hl=en-GB" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("knowten/maps-reviews-fast").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/Yellowstone+National+Park/@44.5857951,-110.5140571,9z/data=!3m1!4b1!4m5!3m4!1s0x5351e55555555555:0xaca8f930348fe1bb!8m2!3d44.427963!4d-110.588455?hl=en-GB" }] } # Run the Actor and wait for it to finish run = client.actor("knowten/maps-reviews-fast").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/Yellowstone+National+Park/@44.5857951,-110.5140571,9z/data=!3m1!4b1!4m5!3m4!1s0x5351e55555555555:0xaca8f930348fe1bb!8m2!3d44.427963!4d-110.588455?hl=en-GB" } ] }' | apify call knowten/maps-reviews-fast --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=knowten/maps-reviews-fast", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Maps Reviews Fast", "description": "Extract Google Maps reviews at scale affordably ($0.25/1k). Get texts, stars, reviewer data, translations, owner responses, and photos. Features a unique \"Deep Search\" mode to bypass Google's pagination limits and scrape the absolute maximum number of reviews per place.", "version": "0.0", "x-build-id": "cFuuYAJjLbgI3E0QL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/knowten~maps-reviews-fast/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-knowten-maps-reviews-fast", "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/knowten~maps-reviews-fast/runs": { "post": { "operationId": "runs-sync-knowten-maps-reviews-fast", "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/knowten~maps-reviews-fast/run-sync": { "post": { "operationId": "run-sync-knowten-maps-reviews-fast", "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": "Google Maps place URLs", "type": "array", "description": "Google Maps search, place, review detail, or cid URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "placeIds": { "title": "Place IDs", "type": "array", "description": "Google Maps Place IDs.", "items": { "type": "string" } }, "maxReviews": { "title": "Number of reviews", "minimum": 1, "type": "integer", "description": "Maximum number of reviews per place. Remove or set a very high value to scrape all available reviews.", "default": 10000000 }, "reviewsSort": { "title": "Sort reviews by", "enum": [ "newest", "mostRelevant", "highestRanking", "lowestRanking" ], "type": "string", "description": "Define how reviews should be sorted.", "default": "newest" }, "deepSearch": { "title": "Deep Search (Bypass Pagination Limits)", "type": "boolean", "description": "If enabled, when the primary sort limit is reached, the scraper will automatically fallback to other sorting methods to bypass Google's ~3,000 review limit and extract maximum possible reviews.", "default": false }, "reviewsStartDate": { "title": "Only scrape reviews newer than [date]", "type": "string", "description": "Absolute date like 2024-05-03 or relative date like 8 days, 3 months, 3 hours." }, "language": { "title": "Language", "enum": [ "", "en", "af", "az", "id", "ms", "bs", "ca", "cs", "da", "de", "et", "es", "es-419", "eu", "fil", "fr", "gl", "hr", "zu", "is", "it", "sw", "lv", "lt", "hu", "nl", "no", "uz", "pl", "pt-BR", "pt-PT", "ro", "sq", "sk", "sl", "fi", "sv", "vi", "tr", "el", "bg", "ky", "kk", "mk", "mn", "ru", "sr", "uk", "ka", "hy", "iw", "ur", "ar", "fa", "am", "ne", "hi", "mr", "bn", "pa", "gu", "ta", "te", "kn", "ml", "si", "th", "lo", "my", "km", "ko", "ja", "zh-CN", "zh-TW" ], "type": "string", "description": "Target language for translated reviews (e.g., 'en', 'es'). If left empty, Google will use its default." }, "reviewsOrigin": { "title": "Reviews origin", "enum": [ "all", "google" ], "type": "string", "description": "Select whether to scrape all reviews or only Google-native reviews when Google exposes this distinction.", "default": "all" }, "personalData": { "title": "Extract personal data", "type": "boolean", "description": "Include reviewer personal data such as name, profile URL, and photo.", "default": true } } }, "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 } } } } } } } } } } ```