> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Maps reviews

> Reviews for a Google Maps place, with star rating, review text, publish date, owner response, review images and visit context, alongside the place's own address

Reviews for a Google Maps place, with star rating, review text, publish date, owner response, review images and visit context, alongside the place's own address, category, total score and review count.

<Note>Use to read what customers actually say about a business or landmark, track rating trends over time, or mine complaints and praise. Identify places by placeIds or Google Maps place URLs. Set personalData to false when you do not need reviewer identities. maxReviews is per place.</Note>

## Price

**\$0.001350 per review.** That is the rate you pay for each review the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer reviews costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field                 | Type                                                        | Required | Notes                                                                                                                                                            |
| --------------------- | ----------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `language`            | `string`                                                    |          | Language the review details are returned in, e.g. en, fr, de, es, it, ro Defaults to `"en"`.                                                                     |
| `placeIds`            | `array`                                                     |          | Google place IDs, e.g. ChIJLU7jZClu5kcR4PcOOO6p3I0. More precise than URLs                                                                                       |
| `startUrls`           | `array`                                                     |          | Google Maps place, search or reviews URLs. Must contain /maps/place, /maps/search or /maps/reviews                                                               |
| `maxReviews`          | `integer`                                                   |          | Maximum reviews PER PLACE. Billed per review. The actor's own default is unlimited, this endpoint defaults to 100 so one call cannot run away Defaults to `100`. |
| `reviewsSort`         | `newest`, `mostRelevant`, `highestRanking`, `lowestRanking` |          | Defaults to `"newest"`.                                                                                                                                          |
| `personalData`        | `boolean`                                                   |          | Include reviewer identity (id, name, profile URL, photo) and the review URL. Set to false to get reviews without personal data Defaults to `false`.              |
| `reviewsOrigin`       | `all`, `google`                                             |          | all includes Tripadvisor and other sources, google restricts to Google reviews Defaults to `"all"`.                                                              |
| `reviewsStartDate`    | `string`                                                    |          | Only reviews newer than this, absolute (2026-05-03) or relative ("3 months")                                                                                     |
| `reviewsFilterString` | `string`                                                    |          | Only reviews containing this keyword                                                                                                                             |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"maps.reviews","input":{"maxReviews":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "url": "https://www.google.com/maps/search/?api=1&query=Eiffel%20Tower&query_place_id=ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "city": "Paris",
  "name": "Priya Raman",
  "text": "It's a tower made of steel. The shaded areas and trees nearby help a lot in summer.",
  "stars": 3,
  "title": "Eiffel Tower",
  "address": "Av. Gustave Eiffel, 75007 Paris, France",
  "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "location": {
    "lat": 48.8583701,
    "lng": 2.2944813
  },
  "reviewId": "Ci9DQUlRQUNvZENodHljRjlvT2t0b05FTjJPV2w0Yg",
  "publishAt": "Edited 2 weeks ago",
  "reviewUrl": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZA",
  "visitedIn": "Visited in July",
  "likesCount": 0,
  "reviewerId": "104712345678901234567",
  "totalScore": 4.7,
  "countryCode": "FR",
  "reviewerUrl": "https://www.google.com/maps/contrib/104712345678901234567",
  "categoryName": "Historical landmark",
  "isLocalGuide": true,
  "reviewOrigin": "Google",
  "reviewsCount": 492458,
  "reviewContext": {
    "Wait time": "Up to 10 min",
    "Visited on": "Weekend"
  },
  "textTranslated": null,
  "publishedAtDate": "2026-07-15T20:02:44.481Z",
  "reviewImageUrls": [
    "https://lh3.googleusercontent.com/grass-cs/example"
  ],
  "originalLanguage": "en",
  "responseFromOwnerDate": null,
  "responseFromOwnerText": null,
  "reviewerNumberOfReviews": 85
}
```