# Google Maps Review Scraper (`taroyamada/google-maps-review-intelligence`) Actor Scrape Google Maps ratings, review snippets, coordinates, and branch reputation signals from public place pages without Places API keys. - **URL**: https://apify.com/taroyamada/google-maps-review-intelligence.md - **Developed by:** [太郎 山田](https://apify.com/taroyamada) (community) - **Categories:** Marketing, Travel, SEO tools - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 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 Intelligence API | Ratings, Snippets & Place Data > **Private / frozen actor:** this actor is not part of public Wave 1. Keep it in private testing only and assume blocked, partial, or snippet-only output can occur. Extract critical data points directly from Google Maps pages to fuel your local search engine optimization strategy and reputation management workflows. This scraper bypasses the need for an expensive Google Places API key by directly extracting structured data from the initial HTML of a Google Maps place page. Local SEO professionals and digital marketing teams use this powerful tool to closely monitor client reputation, track competitor ratings across Google, and build comprehensive datasets for managing hundreds of local store locations or branches. By scheduling a daily or weekly run, you can automate a robust review intelligence pipeline that keeps your local search results data perfectly synced. The scraper uses advanced web parsing techniques to capture highly reliable fields from meta tags, embedded JSON-LD schema, and raw URL coordinates. Concrete outputs include precise details like `og:title`, `og:description`, exact geographic coordinates, aggregate review counts, and public review snippets. Whether you need to scrape local search results for enterprise scale store locations or extract details for a single competitor listing, this tool delivers the exact business details and rating metrics required to maintain a dominant local presence. By extracting these key metrics without heavy browser overhead, users gain rapid insights into their brand visibility. Gather crucial review metrics instantly and feed them into your own internal business dashboards or client reporting tools. ### Private Testing Quickstart - Start with 1–3 full Google Maps place URLs and keep `reviewLimit` around 25. - Use dataset delivery first so you can inspect `warnings`, `dataSources`, and review availability. - Treat review snippets as best-effort: Google often withholds full review text in initial HTML. - After the first useful run, move to the recurring multi-location template, then use the webhook handoff template for action-needed review alerts. ### Data Strategy This actor fetches Google Maps place pages via HTTP and extracts structured data from multiple tiers: 1. **Meta tags** (high reliability): `og:title`, `og:description`, `og:image` 2. **JSON-LD structured data** (high reliability): Embedded `LocalBusiness` schema 3. **Embedded script blocks** (medium reliability): `AF_initDataCallback` data arrays 4. **URL components** (high reliability): Coordinates, place name from URL path 5. **Inline text patterns** (medium reliability): Rating/review patterns in page text #### Limitations - **Individual reviews**: Full review text is typically not available without JavaScript rendering or the Google Places API. The actor returns any review snippets embedded in the initial HTML (often from JSON-LD) and explicitly warns when full reviews are unavailable. - **Rate limiting**: Requests are throttled (2s minimum between requests) to be polite. Heavy use may trigger Google's bot detection. - **Page structure changes**: Google may change their HTML structure at any time. The multi-tier extraction approach provides resilience — if one source breaks, others continue working. ### Use Cases | Who | Why | |---|---| | **Local SEO teams** | Benchmark ratings, review counts, and category fit across locations | | **Franchise operators** | Compare multiple stores or branches with one normalized schema | | **Agencies** | Build lightweight review-monitoring datasets without Google Places API keys | | **Competitive analysts** | Pair Maps reputation signals with Trustpilot or app-review data | ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `placeUrls` | string[] | *(required)* | Google Maps place URLs or share links | | `reviewLimit` | integer | 200 | Max review snippets per place | | `delivery` | string | `"dataset"` | `"dataset"` or `"webhook"` | | `webhookUrl` | string | | Webhook URL for delivery | | `dryRun` | boolean | false | Extract without saving results | #### Supported URL formats - `https://www.google.com/maps/place/Place+Name/` - `https://www.google.com/maps/place/Place+Name/@lat,lng,zoom` - `https://maps.google.com/maps?q=...` - `https://goo.gl/maps/...` (short links — auto-resolved) - `https://maps.app.goo.gl/...` (app share links — auto-resolved) ### Output Each place returns: - **Normalized place metadata**: name, address, coordinates, category, phone, website, etc. - **Review intelligence**: aggregate rating, review count, review snippets (when available) - **Data provenance**: which extraction tiers provided data - **Explicit warnings**: what data couldn't be extracted and why ### Local run ```bash npm start ## Run with input.json npm test ## Run test suite ```` ### Example output ```json { "meta": { "implementationStatus": "live", "dataStrategy": "public_html", "totalSources": 1, "succeeded": 1, "failed": 0 }, "places": [{ "status": "ok", "dataSources": ["meta_tags", "json_ld", "url_components"], "place": { "name": "Tokyo Station", "address": "1 Chome Marunouchi, Chiyoda City, Tokyo", "rating": null, "coordinates": { "lat": 35.6812, "lng": 139.7671 } }, "reviewIntelligence": { "rating": 4.3, "reviewCount": 12456, "snippetCount": 1, "fullReviewsAvailable": false } }] } ``` ### Related Actors Pair this actor with other flagship intelligence APIs in the same portfolio: - [Trustpilot Review Intelligence API](https://apify.com/taroyamada/trustpilot-enterprise-review-aggregator) — add broader brand-level review and reply data beyond location pages. - [G2 & Capterra Review Intelligence API](https://apify.com/taroyamada/g2-capterra-review-intelligence) — compare location sentiment with B2B software review proof points. - [Google Play Intelligence API](https://apify.com/taroyamada/google-play-intelligence) — pair location data with Android app feedback for mobile-first brands. - [Apple App Store Intelligence API](https://apify.com/taroyamada/apple-app-store-intelligence) — mirror the same workflow for iOS storefronts. ### Pricing & Cost Control Apify Store pricing is usage-based, so total cost mainly follows how many `placeUrls` you process. Check the Store pricing card for the current per-event rates. - Start with a few `placeUrls` while validating the schema. - Keep `reviewLimit` low because Google often exposes only snippets anyway. - Use dataset delivery first so blocked or partial cases are easy to inspect. - Use `dryRun: true` before larger location batches or webhook handoffs. ### ⭐ Was this helpful? If this actor saved you time, please [**leave a ★ rating**](https://apify.com/taroyamada/google-maps-review-intelligence/reviews) on Apify Store. It takes 10 seconds, helps other developers discover it, and keeps updates free. Bug report or feature request? Open an issue on the [Issues tab](https://apify.com/taroyamada/google-maps-review-intelligence/issues) of this actor. # Actor input Schema ## `placeUrls` (type: `array`): Google Maps place URLs, share links (goo.gl/maps/…, maps.app.goo.gl/…), or /maps/place/ URLs. ## `reviewLimit` (type: `integer`): Maximum review snippets to return per place. Note: full review extraction requires the Places API; this actor returns whatever review snippets are embedded in the public HTML. ## `delivery` (type: `string`): Where to send results: dataset or webhook. ## `webhookUrl` (type: `string`): Webhook URL to POST results to when delivery=webhook. ## `dryRun` (type: `boolean`): Run extraction without saving to dataset or delivering to webhook. ## Actor input object example ```json { "placeUrls": [ "https://www.google.com/maps/place/Tokyo+Station/" ], "reviewLimit": 200, "delivery": "dataset", "dryRun": false } ``` # 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/place/Tokyo+Station/" ] }; // Run the Actor and wait for it to finish const run = await client.actor("taroyamada/google-maps-review-intelligence").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/place/Tokyo+Station/"] } # Run the Actor and wait for it to finish run = client.actor("taroyamada/google-maps-review-intelligence").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/place/Tokyo+Station/" ] }' | apify call taroyamada/google-maps-review-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=taroyamada/google-maps-review-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Review Scraper", "description": "Scrape Google Maps ratings, review snippets, coordinates, and branch reputation signals from public place pages without Places API keys.", "version": "0.1", "x-build-id": "d1jow6mtvjcExgd2q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/taroyamada~google-maps-review-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-taroyamada-google-maps-review-intelligence", "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/taroyamada~google-maps-review-intelligence/runs": { "post": { "operationId": "runs-sync-taroyamada-google-maps-review-intelligence", "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/taroyamada~google-maps-review-intelligence/run-sync": { "post": { "operationId": "run-sync-taroyamada-google-maps-review-intelligence", "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": "Place URLs", "type": "array", "description": "Google Maps place URLs, share links (goo.gl/maps/…, maps.app.goo.gl/…), or /maps/place/ URLs.", "items": { "type": "string" } }, "reviewLimit": { "title": "Review Limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum review snippets to return per place. Note: full review extraction requires the Places API; this actor returns whatever review snippets are embedded in the public HTML.", "default": 200 }, "delivery": { "title": "Delivery", "enum": [ "dataset", "webhook" ], "type": "string", "description": "Where to send results: dataset or webhook.", "default": "dataset" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Webhook URL to POST results to when delivery=webhook." }, "dryRun": { "title": "Dry Run", "type": "boolean", "description": "Run extraction without saving to dataset or delivering to webhook.", "default": false } } }, "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 } } } } } } } } } } ```