# Google Maps Reviews Scraper - Fast & Reliable (`whoareyouanas/google-maps-review-scraper`) Actor

Scrape Google Maps reviews from place URLs or Place IDs. Extract review text, ratings, dates, owner replies, reviewer details, and business metadata into clean JSON/CSV.

- **URL**: https://apify.com/whoareyouanas/google-maps-review-scraper.md
- **Developed by:** [Anas Nadeem](https://apify.com/whoareyouanas) (community)
- **Categories:** SEO tools, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 review scrapeds

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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 - Fast & Reliable

Scrape Google Maps reviews from place URLs or Place IDs and export clean JSON, CSV, Excel, or API-ready data. Built for reputation monitoring, local SEO, competitor research, customer feedback analysis, and AI/RAG review datasets.

No Google Maps API key is required. Add places, choose how many reviews you need, select the review sort order, and get structured place metadata plus one row per review.

### What You Get

- Full Google Maps review rows with rating, review text, date, owner response, likes, review URL, and reviewer details when visible.
- Place metadata including title, category, address, phone, website, rating, total review count, CID, FID, and coordinates when visible.
- Support for Google Maps place URLs and Google Place IDs.
- Review sorting by newest, most relevant, highest rating, or lowest rating.
- Clean mixed dataset with `placeSummary` rows and `review` rows.
- Explicit `dataQualityStatus` values so blocked, partial, or invalid runs are easy to detect.
- Simple output designed for CSV export, dashboards, automations, sentiment analysis, and enrichment pipelines.

### Pricing

Recommended Apify Store pricing:

- Pricing model: pay per event
- Event: `review-scraped`
- Price: `$0.00025` per review
- Effective rate: `$0.25 per 1,000 reviews`
- Actor start event: `$0.00005` per run

Place summary rows are included at no extra charge. Runs that cannot extract reviews are not charged for review events.

### Input

```json
{
  "placeUrls": [
    "https://www.google.com/maps/place/Aligarh+House+Restaurant+-+HSR/@12.9084006,77.6325664,17z/data=!3m1!4b1!4m6!3m5!1s0x3bae1570d7a8549f:0x3d107e987ed1f50f!8m2!3d12.9083954!4d77.6351413!16s%2Fg%2F11v6bf6td0"
  ],
  "maxReviews": 100,
  "sort": "newest",
  "language": "en",
  "region": "US",
  "includeReviewerDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
````

You can also provide Place IDs:

```json
{
  "placeIds": ["ChIJ..."],
  "maxReviews": 20,
  "sort": "relevant"
}
```

### Input Options

- `placeUrls` - Google Maps place URLs. Direct `/maps/place` URLs are recommended.
- `placeIds` - Google Place IDs when you do not have full Maps URLs.
- `maxReviews` - Maximum reviews per place. Use `0` for the actor safety cap of 1,000.
- `sort` - `newest`, `relevant`, `highest`, or `lowest`.
- `language` - Google Maps interface language code, for example `en`.
- `region` - Google Maps region code, for example `US` or `IN`.
- `includeReviewerDetails` - Include reviewer name and profile URL when visible.
- `proxyConfiguration` - Start without Apify Proxy; use residential or custom proxies if Google limits the session.

### Output

The default dataset contains two record types.

#### `placeSummary`

```json
{
  "recordType": "placeSummary",
  "title": "Aligarh House Restaurant - HSR",
  "category": "Biryani restaurant",
  "address": "383, 9th Main Rd, 7th Sector, HSR Layout, Bengaluru, Karnataka 560102, India",
  "rating": 4.2,
  "reviewsCount": 1630,
  "scrapedReviewsCount": 100,
  "cid": "0x3d107e987ed1f50f",
  "dataQualityStatus": "ok"
}
```

#### `review`

```json
{
  "recordType": "review",
  "placeTitle": "Aligarh House Restaurant - HSR",
  "reviewerName": "A Reviewer",
  "stars": 5,
  "text": "Great food and quick service.",
  "publishedAtText": "a week ago",
  "publishedAt": "2026-07-07",
  "ownerResponseText": "Thanks for visiting!",
  "likesCount": 2,
  "reviewUrl": "https://www.google.com/maps/reviews/..."
}
```

### Data Quality

Google Maps can return limited content depending on IP, proxy, region, language, and session state. The actor reports this directly:

- `ok` - place details and requested reviews were extracted.
- `partial` - place details or some reviews were extracted, but the session was limited.
- `blocked` - Google Maps did not expose usable review data.
- `invalid_input` - the input URL or Place ID could not be resolved.

The actor starts with `useApifyProxy: false` by default because this has produced more reliable Google Maps review panels in current cloud tests. Use residential or custom proxies if your run is blocked or needs a specific region.

### Best For

- Local SEO review audits
- Reputation monitoring
- Competitor review research
- Sentiment analysis
- Customer support workflows
- Review exports for BI tools
- AI/RAG datasets built from customer feedback

### Local Development

```bash
npm install
npm test
npm run build
```

# Actor input Schema

## `placeUrls` (type: `array`):

One or more Google Maps place URLs. Direct /maps/place URLs are recommended.

## `placeIds` (type: `array`):

Optional Google Place IDs. Use this when you do not have a full Maps URL.

## `maxReviews` (type: `integer`):

Maximum reviews to extract for each place. Use 0 for the actor safety cap of 1,000.

## `sort` (type: `string`):

Order reviews before extraction.

## `language` (type: `string`):

Google Maps interface language code.

## `region` (type: `string`):

Google Maps region code.

## `includeReviewerDetails` (type: `boolean`):

Include reviewer name and profile URL when visible.

## `proxyConfiguration` (type: `object`):

Proxy settings. Start without Apify Proxy; use residential/custom proxies if Google limits the session.

## `debugMode` (type: `boolean`):

Enable extra logs and slower browser actions.

## Actor input object example

```json
{
  "placeUrls": [
    "https://www.google.com/maps/place/Aligarh+House+Restaurant+-+HSR/@12.9084006,77.6325664,17z/data=!3m1!4b1!4m6!3m5!1s0x3bae1570d7a8549f:0x3d107e987ed1f50f!8m2!3d12.9083954!4d77.6351413!16s%2Fg%2F11v6bf6td0"
  ],
  "placeIds": [],
  "maxReviews": 20,
  "sort": "newest",
  "language": "en",
  "region": "US",
  "includeReviewerDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "debugMode": 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "placeUrls": [
        "https://www.google.com/maps/place/Aligarh+House+Restaurant+-+HSR/@12.9084006,77.6325664,17z/data=!3m1!4b1!4m6!3m5!1s0x3bae1570d7a8549f:0x3d107e987ed1f50f!8m2!3d12.9083954!4d77.6351413!16s%2Fg%2F11v6bf6td0"
    ],
    "placeIds": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("whoareyouanas/google-maps-review-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "placeUrls": ["https://www.google.com/maps/place/Aligarh+House+Restaurant+-+HSR/@12.9084006,77.6325664,17z/data=!3m1!4b1!4m6!3m5!1s0x3bae1570d7a8549f:0x3d107e987ed1f50f!8m2!3d12.9083954!4d77.6351413!16s%2Fg%2F11v6bf6td0"],
    "placeIds": [],
}

# Run the Actor and wait for it to finish
run = client.actor("whoareyouanas/google-maps-review-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/place/Aligarh+House+Restaurant+-+HSR/@12.9084006,77.6325664,17z/data=!3m1!4b1!4m6!3m5!1s0x3bae1570d7a8549f:0x3d107e987ed1f50f!8m2!3d12.9083954!4d77.6351413!16s%2Fg%2F11v6bf6td0"
  ],
  "placeIds": []
}' |
apify call whoareyouanas/google-maps-review-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=whoareyouanas/google-maps-review-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Maps Reviews Scraper - Fast & Reliable",
        "description": "Scrape Google Maps reviews from place URLs or Place IDs. Extract review text, ratings, dates, owner replies, reviewer details, and business metadata into clean JSON/CSV.",
        "version": "0.1",
        "x-build-id": "l6ucZo9Re6vfVSV8m"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/whoareyouanas~google-maps-review-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-whoareyouanas-google-maps-review-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/whoareyouanas~google-maps-review-scraper/runs": {
            "post": {
                "operationId": "runs-sync-whoareyouanas-google-maps-review-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/whoareyouanas~google-maps-review-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-whoareyouanas-google-maps-review-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": {
                    "placeUrls": {
                        "title": "Google Maps place URLs",
                        "type": "array",
                        "description": "One or more Google Maps place URLs. Direct /maps/place URLs are recommended.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "placeIds": {
                        "title": "Google Place IDs",
                        "type": "array",
                        "description": "Optional Google Place IDs. Use this when you do not have a full Maps URL.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxReviews": {
                        "title": "Max reviews per place",
                        "minimum": 0,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Maximum reviews to extract for each place. Use 0 for the actor safety cap of 1,000.",
                        "default": 20
                    },
                    "sort": {
                        "title": "Review sort",
                        "enum": [
                            "newest",
                            "relevant",
                            "highest",
                            "lowest"
                        ],
                        "type": "string",
                        "description": "Order reviews before extraction.",
                        "default": "newest"
                    },
                    "language": {
                        "title": "Language",
                        "type": "string",
                        "description": "Google Maps interface language code.",
                        "default": "en"
                    },
                    "region": {
                        "title": "Region",
                        "type": "string",
                        "description": "Google Maps region code.",
                        "default": "US"
                    },
                    "includeReviewerDetails": {
                        "title": "Include reviewer details",
                        "type": "boolean",
                        "description": "Include reviewer name and profile URL when visible.",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings. Start without Apify Proxy; use residential/custom proxies if Google limits the session.",
                        "default": {
                            "useApifyProxy": false
                        }
                    },
                    "debugMode": {
                        "title": "Debug mode",
                        "type": "boolean",
                        "description": "Enable extra logs and slower browser actions.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```