---
title: "Get place reviews"
method: GET
path: "/v1/google/maps/reviews"
tags: ["Google Maps"]
---

# Get place reviews

`GET /v1/google/maps/reviews`

Get reviews for a Google Maps place via the protobuf API.

The ``data_id`` is the hex pair from ``/maps/search`` results
(e.g. ``0x89c259617ae5b78b:0xe919ce17bb09920e``). Supports both
offset-based and token-based pagination.

## Query parameters

- `data_id` string, required — Google Maps data ID (0x...:0x...)
- `sort_by` 'qualityScore' | 'newestFirst' | 'ratingHigh' | 'ratingLow' — Sort order
- `hl` string — Language code
- `gl` string — Country code
- `next_page_token` string, nullable — Pagination token from previous response
- `offset` integer — Review offset (0-based)
- `results` integer — Reviews per page

## Response `200`

Successful Response

- MapsReviewsResponse — Response for GET /api/v1/maps/reviews.
  - `location` MapsLocationInfo — Location summary in review responses.
    - `title` string, required
    - `address` string, nullable
    - `rating` number, nullable
    - `reviews_count` integer, nullable
  - `topics` MapsReviewTopic[]
    - `keyword` string, required
    - `mentions` integer
    - `id` string, nullable
  - `reviews` MapsReview[]
    - `rating` integer, required
    - `text` string, nullable
    - `date` string, nullable
    - `iso_date` string, nullable
    - `user` MapsReviewUser — User who wrote a review.
      - `name` string, required
      - `contributor_id` string, nullable
      - `thumbnail` string, nullable
      - `local_guide` boolean
      - `reviews_count` integer, nullable
      - `photos_count` integer, nullable
    - `likes` integer
    - `images` string[]
    - `response_from_owner` MapsOwnerResponse — Business owner response to a review.
      - `text` string, required
      - `date` string, nullable
  - `pagination` Pagination, required — Pagination metadata.
    - `current` union
      - integer
      - string
    - `next` string, nullable
    - `total_results` integer, nullable
    - `total_pages` integer, nullable
    - `page_no` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)