---
title: "Google Maps place reviews API"
method: GET
path: "/google/map/place/{place_id}/reviews"
tags: ["Google"]
---

# Google Maps place reviews API

`GET /google/map/place/{place_id}/reviews`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/google/map/place/{place_id}/reviews`
- Auth: API key in header `x-api-key`

Returns the reviews Google shows on a specified place_id's Google Maps page —
typically the 8 most relevant, each with its rating, text, reviewer, timestamp, and
any photos the reviewer attached. Photo-only reviews return an empty `text`.
This is the place page's first page of reviews, not the full review archive.
Rate limit is enforced at 1 request per second.

## Path parameters

- `place_id` string, required

## Query parameters

- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoogleMapPlaceReviewsResponseDoc
  - `code` integer
  - `data` GooglePlaceReview[]
    - `author_id` string: AuthorID is the reviewer's stable Google contributor id.
    - `author_name` string: AuthorName is the reviewer's display name.
    - `author_photo` string: AuthorPhoto is the reviewer's avatar URL.
    - `author_review_count` integer: AuthorReviewCount is how many reviews this contributor has written in total, as reported by Google. 0 means not captured, and is normal for a review syndicated from another site.
    - `author_url` string: AuthorURL is the reviewer's public Google Maps contributor page.
    - `id` string: ID is Google's opaque review identifier, stable across fetches.
    - `photos` GooglePlacePhoto[]: Photos are the images attached to this review, largest variant first.
      - `height` integer: Pixel height of the image at its URL. 0 when Google does not report it.
      - `url` string: URL is Google's image URL exactly as served, including its size suffix (e.g. `=w203-h100-k-no`). Swap that suffix to request other dimensions.
      - `width` integer: Width and Height are the pixel dimensions of the URL as served, when Google reports them. 0 means not captured.
    - `published_at` string: PublishedAt is the review timestamp in RFC3339 (UTC). Empty when Google did not report one.
    - `rating` integer: Rating is the star rating this reviewer gave, 1-5.
    - `relative_time` string: RelativeTime is Google's own human-readable age for the review, in the requested language (e.g. "6 months ago").
    - `source` string: Source is the site the review came from. Google's place pages syndicate reviews from partner sites (notably for hotels), so this is "Google" for a native Google review and the partner's name (e.g. "Tripadvisor", "TrustYou") otherwise.
    - `text` string: Text is the review body. Empty for a photo-only review, which Google allows.
  - `msg` string

## Other responses

- `400`: Invalid input
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)