# Google Maps Reviews Scraper: Ratings, Replies, Dates (`automatic/google-maps-reviews-scraper`) Actor

Export public Google Maps reviews: stars, full text, exact date, reviewer, photos and owner replies, plus each place's star breakdown. Paste share links, place IDs or searches, and keep only recent reviews such as the last 30 days. Translated reviews come with the original.

- **URL**: https://apify.com/automatic/google-maps-reviews-scraper.md
- **Developed by:** [Philip Kirkbride](https://apify.com/automatic) (community)
- **Categories:** Marketing, SEO tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.40 / 1,000 reviews

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Maps Reviews Scraper

Export every public Google Maps review of the places you care about: star rating, full text, exact date, reviewer, photos and the owner's reply. Paste a place link (share links work), a place ID or a search such as "dentist in Denver", and get one clean row per review for spreadsheets, dashboards or sentiment analysis.

- **Every review, newest first or by rating**: sort by newest, most relevant, highest or lowest rated, and collect up to 10,000 reviews per place.
- **Only what's new**: keep reviews from the last 30 days (or since any date), or run on a schedule and save only reviews you haven't collected before.
- **Owner replies included**: see which reviews got an answer, what the owner said and when.
- **Rich reviewer and place details**: reviewer name, profile, review and photo counts, Local Guide badge, plus each place's rating, review count, category, address and its 1-to-5-star breakdown.
- **Any language**: reviews arrive translated into your language, with the original text kept alongside.

**Press Start with the prefilled input** for 10 of the newest Epoch Coffee reviews in a few seconds.

### Use cases

- **Reputation monitoring**: schedule a daily run per client and get only new reviews, ready for alerts.
- **Local SEO reports**: compare ratings, review volume and star breakdowns across competitors in an area.
- **Customer feedback analysis**: feed review text, aspect ratings (Food, Service, Atmosphere) and owner replies into sentiment or topic models.
- **Response tracking**: find negative reviews that still have no owner reply.

### Also available

The reviews and reputation suite: pick the job.

| Actor | Use when |
|---|---|
| **Google Maps Reviews (this Actor)** | Every review of a place, with owner replies |
| [Google Maps Places](https://apify.com/automatic/google-maps-places-scraper) | Local businesses with phone, website and ratings |
| [Trustpilot Reviews](https://apify.com/automatic/trustpilot-reviews-scraper) | Customer reviews and TrustScores by company |
| [Yelp Business](https://apify.com/automatic/yelp-business-scraper) | Yelp ratings, hours and contact details |
| [Google Play](https://apify.com/automatic/google-play-scraper) | App details, installs and user reviews |

### How to use it

Add places in any of these ways, and combine them in one run. Each place and review is saved once per run.

- **Place links**: copy the link from the Google Maps share button (`https://maps.app.goo.gl/...`) or from the address bar.
- **Place IDs**: standard Google place IDs such as `ChIJG-gJw2vKRIYROWi2uwOp8QE`.
- **Searches**: business names or categories, with an optional location. The top places of each search are collected.

```json
{
  "placeUrls": ["https://maps.app.goo.gl/M6CAxsPXhBh1rbJG7"],
  "placeIds": ["ChIJG-gJw2vKRIYROWi2uwOp8QE"],
  "sort": "newest",
  "reviewsStartDate": "30 days",
  "maxReviewsPerPlace": 200
}
```

Reviews of the top 3 dentists and orthodontists in Denver:

```json
{
  "searchQueries": ["dentist", "orthodontist"],
  "location": "Denver, CO",
  "maxPlaces": 3,
  "maxReviewsPerPlace": 50,
  "maxItems": 300
}
```

| Input | Meaning |
| --- | --- |
| `placeUrls` | Google Maps place links: share links (`maps.app.goo.gl`), address-bar links or links with `query_place_id`. Search links are searched. Up to 100. |
| `placeIds` | Google place IDs that start with `ChIJ`. Up to 100; links and IDs together may name up to 100 places. |
| `searchQueries` | Business names or categories, one per line, for example `dentist`. Up to 100. |
| `location` | City or area added to every search, for example `Austin, TX`. Optional when the terms already name the area. |
| `maxPlaces` | Places taken from each search. Default 5; maximum 100. |
| `maxReviewsPerPlace` | Reviews read per place, including ones skipped by the date filter or saved before. Default 100; maximum 10,000. |
| `maxItems` | Maximum reviews saved in the whole run. Default 200; maximum 100,000. |
| `sort` | `newest` (default), `mostRelevant`, `highest` or `lowest`. |
| `reviewsStartDate` | Keep only reviews newer than a date (`2026-11-01`), a UTC time (`2026-11-01T12:00:00Z`) or a period (`30 days`, `2 weeks`, `6 months`, `1 year`). With `newest`, reading a place stops once older reviews begin. |
| `language` | Language for review text, for example `en`, `de` or `pt-BR`. Default `en`. |
| `onlyNewSinceLastRun` | Save only reviews not saved by earlier runs with the same `ledgerName`. Default false. |
| `ledgerName` | Name of the saved-review history. Default `google-maps-reviews-ledger`; use one name per client or campaign. |

An empty input (`{}`) returns a small announced sample of 10 Epoch Coffee reviews. A single bad link or ID is skipped and named in the run status, and unknown input fields are ignored with a note. If nothing in the input can be used, or the places simply have no matching reviews, the run ends successfully with `no_results` and says why.

### Scheduled monitoring

Turn on `onlyNewSinceLastRun`, keep the same `ledgerName` and schedule the run. The first run saves the current reviews as its baseline; every later run saves only reviews it has not seen before, so a quiet day costs only the run start.

```json
{
  "placeIds": ["ChIJG-gJw2vKRIYROWi2uwOp8QE"],
  "sort": "newest",
  "maxReviewsPerPlace": 200,
  "reviewsStartDate": "30 days",
  "onlyNewSinceLastRun": true,
  "ledgerName": "agency-client-a-reviews"
}
```

Use a separate `ledgerName` for each client. Raise `maxReviewsPerPlace` if a place gets more new reviews between runs than you read. A run stopped by its spending limit leaves the remaining reviews for the next run.

### What you get

One row per review:

| Field | Meaning |
| --- | --- |
| `rating`, `text`, `publishedAt` | Stars (1 to 5), review text in your language and the exact publication time in UTC. |
| `originalLanguageText`, `isTranslated`, `language` | Original text when Google translated it, and its language. |
| `reviewDetailedRating`, `reviewContext` | Aspect stars such as Food, Service and Atmosphere, and answers such as Order type or Price per person, when the reviewer gave them. |
| `ownerResponseText`, `ownerResponseDateText` | The owner's reply and when it was posted, as Google shows it (for example `5 days ago`). |
| `reviewerName`, `reviewerId`, `reviewerProfileUrl`, `reviewerPhotoUrl` | Public reviewer identity and profile. |
| `reviewerReviewCount`, `reviewerPhotoCount`, `isLocalGuide` | The reviewer's review and photo counts and Local Guide badge. |
| `photoUrls` | Photos attached to the review. |
| `reviewId`, `reviewUrl`, `reviewOrigin` | Stable review ID, direct link to the review and where it was written. |
| `placeName`, `placeId`, `placeUrl`, `placeAddress`, `placeCategory` | The place the review belongs to. |
| `placeRating`, `placeTotalReviews`, `placeReviewsDistribution` | The place's average rating, review count and number of 1- to 5-star reviews. |
| `searchQuery` | The search that found the place, for places found by search. |

Download as JSON, CSV or Excel. The run's OUTPUT record adds a summary per place (rating, review count, star breakdown, reviews saved and why collection stopped) and lists any skipped inputs.

### Output example

A row from the prefilled input, captured on 2026-11-15:

```json
{
  "reviewId": "Ci9DQUlRQUNvZENodHljRjlvT25kd1RHMXJSazVMWjJkM1gySnhZbTVpZEdKSWNHYxAB",
  "reviewUrl": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25kd1RHMXJSazVMWjJkM1gySnhZbTVpZEdKSWNHYxAB!2m1!1s0x0:0x1f1a903bbb66839!3m1!1s2@1:CAIQACodChtycF9oOndwTG1rRk5LZ2d3X2JxYm5idGJIcGc%7C%7C?hl=en-GB",
  "placeId": "ChIJG-gJw2vKRIYROWi2uwOp8QE",
  "placeName": "Epoch Coffee",
  "placeUrl": "https://www.google.com/maps/search/?api=1&query=Epoch+Coffee&query_place_id=ChIJG-gJw2vKRIYROWi2uwOp8QE",
  "placeAddress": "221 W N Loop Blvd, Austin, TX 78751",
  "placeCategory": "Coffee shop",
  "placeRating": 4.5,
  "placeTotalReviews": 2542,
  "placeReviewsDistribution": {
    "oneStar": 86,
    "twoStar": 60,
    "threeStar": 150,
    "fourStar": 463,
    "fiveStar": 1783
  },
  "searchQuery": null,
  "rating": 5,
  "text": "Best coffee shop in Austin and has been for decades",
  "originalLanguageText": null,
  "isTranslated": false,
  "language": "en",
  "publishedAt": "2026-11-01T13:15:23.155Z",
  "reviewDetailedRating": {
    "Food": 5,
    "Service": 5,
    "Atmosphere": 5
  },
  "reviewContext": {
    "Order type": "Dine in"
  },
  "reviewOrigin": "Google",
  "likes": null,
  "ownerResponseText": null,
  "ownerResponseDate": null,
  "ownerResponseDateText": null,
  "reviewerName": "David Houke",
  "reviewerId": "108992897742919503429",
  "reviewerProfileUrl": "https://www.google.com/maps/contrib/108992897742919503429/reviews?hl=en-GB",
  "reviewerPhotoUrl": "https://lh3.googleusercontent.com/a-/ALV-UjXg-M0sG2hzRO5RPgsrTJInXIV4RbOwbo0en2OnOrpGdGvY0HmL=s64-c-rp-mo-ba12-br100",
  "reviewerReviewCount": 18,
  "reviewerPhotoCount": 5,
  "isLocalGuide": true,
  "photoUrls": [],
  "scrapedAt": "2026-11-15T03:46:46Z"
}
```

### Pricing

**$0.0004 per review ($0.40 per 1,000) plus $0.002 per run start.** One result is one saved review. Place summaries and errors do not create billable review rows. The start fee is charged per GB of memory, with a minimum of one; the default 512 MB run is one start event.

| Example at 512 MB | Reviews | Cost |
| --- | ---: | ---: |
| Console prefill | 10 | $0.006 |
| Monitoring check with nothing new | 0 | $0.002 |
| 1,000 reviews | 1,000 | $0.402 |
| 10,000 reviews | 10,000 | $4.002 |

Set `maxItems` to bound saved reviews, and use the run's spending limit to cap the total event cost.

### Good to know

- Public Google Maps reviews only; nothing behind a login. Some reviews have no text, reply or photos.
- Google does not show like counts or exact owner-reply dates to logged-out visitors, so `likes` and `ownerResponseDate` are always null; `ownerResponseDateText` gives the reply time as shown.
- Links that show only a name or map coordinates cannot be matched to one exact place; open the place in Google Maps and share its link instead. Expired short links are reported and skipped.
- Review history was measured to 1,000 distinct reviews for one place; deeper availability varies, within the 10,000-review limit per place.
- Saved history identifies reviews by place and review ID; edited reviews with a saved ID are skipped. Only one run can use a ledger at a time; a second run returns no reviews and asks you to retry or use a different `ledgerName`.
- If a monitoring run is interrupted, a few reviews from that run may be skipped; run once without monitoring to backfill.
- Unavailable places and Google Maps errors are named in OUTPUT; saved reviews remain available. Runs nearing their time limit finish with partial results.

# Actor input Schema

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

Links to Google Maps places: share links (https://maps.app.goo.gl/...), full place links copied from the address bar, or links with query_place_id. Google Maps search links are searched too. Leave every source empty for a ten-review sample.

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

Google place IDs, for example ChIJG-gJw2vKRIYROWi2uwOp8QE. Standard IDs that start with ChIJ are supported; for other formats paste the place link instead.

## `searchQueries` (type: `array`):

Business names or categories to search on Google Maps, one per line, for example dentist or Joe's Pizza. Add a location below, or include the area in each term. Reviews are collected from the top places of every search.

## `location` (type: `string`):

City or area added to every search, for example Austin, TX or Berlin, Germany. Optional when the search terms already name the area.

## `maxPlaces` (type: `integer`):

How many top places to take from each search, for example 3. Places given by link or ID are always included.

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

Maximum distinct reviews to inspect per place, including reviews excluded by date or already seen. Example: 200. Limits work on scheduled runs too.

## `maxItems` (type: `integer`):

Maximum review rows saved across all places, for example 200. Set 1 for one review.

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

Order to request from Google Maps, for example newest for scheduled monitoring.

## `reviewsStartDate` (type: `string`):

A date (2026-11-01), a UTC timestamp (2026-11-01T12:00:00Z) or a period such as 30 days, 2 weeks, 6 months or 1 year. Leave empty for every date. With Newest order the run stops reading a place once it reaches older reviews.

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

Language for review text, for example en, de or pt-BR. Reviews written in another language are translated by Google; the original text is kept in originalLanguageText.

## `onlyNewSinceLastRun` (type: `boolean`):

Save only review IDs absent from the named ledger. Use the same ledgerName on repeat runs; example true. The first enabled run establishes its baseline by saving reviews.

## `ledgerName` (type: `string`):

Saved-review history name, for example agency-client-a-reviews. Separate names are independent; a second run with the same name succeeds with zero reviews while the first is using it.

## Actor input object example

```json
{
  "placeIds": [
    "ChIJG-gJw2vKRIYROWi2uwOp8QE"
  ],
  "maxPlaces": 5,
  "maxReviewsPerPlace": 10,
  "maxItems": 10,
  "sort": "newest",
  "language": "en",
  "onlyNewSinceLastRun": false,
  "ledgerName": "google-maps-reviews-ledger"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "placeIds": [
        "ChIJG-gJw2vKRIYROWi2uwOp8QE"
    ],
    "maxReviewsPerPlace": 10,
    "maxItems": 10,
    "sort": "newest",
    "language": "en"
};

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

# Prepare the Actor input
run_input = {
    "placeIds": ["ChIJG-gJw2vKRIYROWi2uwOp8QE"],
    "maxReviewsPerPlace": 10,
    "maxItems": 10,
    "sort": "newest",
    "language": "en",
}

# Run the Actor and wait for it to finish
run = client.actor("automatic/google-maps-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "placeIds": [
    "ChIJG-gJw2vKRIYROWi2uwOp8QE"
  ],
  "maxReviewsPerPlace": 10,
  "maxItems": 10,
  "sort": "newest",
  "language": "en"
}' |
apify call automatic/google-maps-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automatic/google-maps-reviews-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

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