# Google Maps Reviews Scraper (`hipersoft/google-maps-reviews`) Actor

Scrape reviews for any place on Google Maps: reviewer, star rating, review text and date. Provide place IDs (from the Google Maps Scraper) or place names. For reputation monitoring and local research.

- **URL**: https://apify.com/hipersoft/google-maps-reviews.md
- **Developed by:** [hiper soft](https://apify.com/hipersoft) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0006 / review scraped

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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 — Reviewer, Rating, Text & Date

Pull the **reviews for any place on Google Maps** into clean, structured **JSON, CSV, Excel or XML**. Give it place names (e.g. "Katz's Delicatessen New York") or Google **Place IDs / Maps URLs**, and this scraper returns each review's **author, star rating, text and relative date**. Fast and reliable, ideal for reputation monitoring, competitor research and local market analysis.

![Google Maps Reviews input — place searches, Place IDs and reviews-per-place in the Apify Console](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/google-maps-reviews-input.png)

### What does Google Maps Reviews Scraper do?

This Google Maps reviews scraper turns public place reviews into a structured dataset. Provide place names or Place IDs and it returns a record per review with the reviewer name, rating, text and relative date, each tagged with its `placeId`. Use it for reputation monitoring, sentiment analysis and competitor benchmarking, and export the results in any format the Apify platform supports.

### What data can you scrape from Google Maps reviews?

| Data point | Description |
| --- | --- |
| Place id | The Google Place ID the review belongs to. |
| Review id | Unique identifier for the review. |
| Author | Reviewer display name. |
| Rating | Star rating from 1 to 5. |
| Review text | Full text of the review. |
| Relative date | When the review was posted, e.g. "2 weeks ago". |

### Use cases

- **Reputation monitoring** — catch new negative reviews of your own business early.
- **Competitor research** — benchmark a competitor's ratings and read customer praise and complaints.
- **Sentiment analysis** — collect qualitative review text for NLP and product research.
- **Multi-location tracking** — track review trends across many locations from a single run.
- **Dataset building** — assemble a structured feed of place reviews.

### How to scrape Google Maps reviews

1. Add **Google Maps Reviews Scraper** to your Apify account and open its input.
2. Enter place names under **searches**, or paste exact **placeIds** (ChIJ… IDs or Maps URLs).
3. Set **maxReviewsPerPlace** to control how many reviews to collect per place.
4. Click **Run**.
5. Export the results as JSON, CSV, Excel or XML, or fetch them through the Apify API.

### Input

```json
{
  "searches": ["Katz's Delicatessen New York"],
  "placeIds": ["ChIJ_0123456789abcdefghijklmn"],
  "maxReviewsPerPlace": 30
}
```

| Field | Description |
| --- | --- |
| `searches` | Place names to look up and scrape reviews for (one per line). |
| `placeIds` | Optional Google Place IDs (ChIJ…) or Maps place URLs — e.g. chained from the Maps Scraper. |
| `maxReviewsPerPlace` | How many reviews to scrape per place (1–500), newest / most-relevant first. |
| `proxyConfiguration` | Standard Apify proxy settings for the run. |

### What you get

One record per review, each tagged with its `placeId`. Ready to export to CSV, Excel, JSON or XML.

![Google Maps Reviews output example — review rows with author, rating and text as structured JSON](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/google-maps-reviews-output.png?v=1)

```json
{
  "placeId": "ChIJ_0123456789abcdefghijklmn",
  "reviewId": "ChdDSUhNMG9nS0VJQ0FnSUNabABEE",
  "author": "Jamie R.",
  "rating": 5,
  "relativeDate": "2 weeks ago",
  "text": "Best pastrami in the city. The line moves fast and it's worth every minute."
}
```

#### Output schema

| Field | Type | Description |
| --- | --- | --- |
| `placeId` | string | The Google Place ID the review belongs to. |
| `reviewId` | string | Unique identifier for the review. |
| `author` | string | Reviewer display name. |
| `rating` | integer | Star rating from 1 to 5. |
| `relativeDate` | string | When the review was posted (e.g. "2 weeks ago"). |
| `text` | string | Full text of the review. |

### Need more local & review data?

- [Google Maps Scraper](https://apify.com/hipersoft/google-maps-scraper) — find places by keyword and location and get Place IDs to feed straight into this actor.
- [Google Maps Email Extractor](https://apify.com/hipersoft/google-maps-email-extractor) — turn Maps listings into contactable leads with emails and socials.
- [Trustpilot Reviews Scraper](https://apify.com/hipersoft/trustpilot-reviews-scraper) — collect ratings, text and company replies from Trustpilot.

### FAQ

**Do I need an account or API key?**
No. There is no login or key — just add place names or Place IDs and click Run.

**How many reviews can I get per place?**
Set `maxReviewsPerPlace` from 1 to 500. Pass many places in one run to collect reviews across multiple locations at once.

**Can I chain this with the Google Maps Scraper?**
Yes. Feed Place IDs from the Google Maps Scraper output straight into `placeIds`.

**Does it collect reviewer contact info?**
No. It captures the reviewer's display name, rating, text and relative date — no private contact details.

**What export formats are available?**
JSON, CSV, Excel and XML, plus programmatic access through the Apify API.

**Can I connect this to my other tools?**
The Google Maps Reviews Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JavaScript/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

**Is scraping Google Maps reviews legal?**
This actor reads only publicly visible reviews. You are responsible for using the data responsibly and in line with applicable laws and Google's terms.

### Related Actors

- [Google Maps Scraper](https://apify.com/hipersoft/google-maps-scraper)
- [Google Maps Email Extractor](https://apify.com/hipersoft/google-maps-email-extractor)
- [App Store Reviews Scraper](https://apify.com/hipersoft/appstore-reviews-scraper)

### Notes

Original clean-room implementation. Reads only publicly visible reviews; you are responsible for compliant use. Not affiliated with Google; Google Maps is a trademark of Google LLC.

# Actor input Schema

## `searches` (type: `array`):

Place names to look up and scrape reviews for (e.g. "Katz's Delicatessen New York"). One per line.

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

Google Place IDs (ChIJ...) or Google Maps place URLs — e.g. chained from the Google Maps Scraper output. One per line.

## `maxReviewsPerPlace` (type: `integer`):

How many reviews to scrape per place (newest/most-relevant first).

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

Residential proxy recommended.

## Actor input object example

```json
{
  "searches": [
    "Katz's Delicatessen New York"
  ],
  "placeIds": [],
  "maxReviewsPerPlace": 30,
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searches": [
        "Katz's Delicatessen New York"
    ],
    "placeIds": []
};

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

# Prepare the Actor input
run_input = {
    "searches": ["Katz's Delicatessen New York"],
    "placeIds": [],
}

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/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 '{
  "searches": [
    "Katz'\''s Delicatessen New York"
  ],
  "placeIds": []
}' |
apify call hipersoft/google-maps-reviews --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/SLUlFjnOP9ONEHnb1/builds/fvLuSd1gsUoK5o08P/openapi.json