Place reviews API

Fetches the Google reviews of a single place addressed by its data_id (from Google Maps places), a place_id, or a name + location that is resolved to the first matching place. Paginates through Google's reviews feed until max_results.

$0.0005 per delivered review, up to 100 reviews per run. Nothing delivered means nothing charged.

Inputs

• data_id (string) — Feature id "0x…:0x…" from Google Maps places (preferred).
• place_id (string) — Google place id (ChIJ…), alternative to data_id.
• query (string) — Alternative to ids: business name, resolved to the first place found.
• location (string) — Where to look the name up (with query).
• sort_by (string) — Review ordering.
• country (string) — ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool.
• lang (string) — Interface language (hl), e.g. en, it, de.
• max_results (integer) — How many reviews to deliver at most (1–100). You pay only for delivered reviews.

What one review looks like

• rank (integer) — 1-based position.
• review_id (string, nullable) — Google's review id.
• rating (number, nullable) — Stars (1–5).
• date (string, nullable) — Relative date as shown ("2 months ago").
• iso_date (string, nullable) — ISO 8601 timestamp when exposed.
• text (string, nullable) — Review body.
• author (string, nullable) — Reviewer display name.
• author_url (string, nullable) — Reviewer's Maps contributor page.
• author_thumbnail (string, nullable) — Reviewer photo URL.
• link (string, nullable) — Direct link to the review.
• source (string, nullable) — Review source (Google, Tripadvisor…).
• images (string[]) — Photos attached to the review.
• owner_response_date (string, nullable) — Owner reply date.
• owner_response_text (string, nullable) — Owner reply text.
• data_id (string) — The place's data_id the review belongs to.
• place_name (string, nullable) — Place name when resolved from query.

FAQ

What does the Place reviews API return?

Fetches the Google reviews of a single place addressed by its data_id (from Google Maps places), a place_id, or a name + location that is resolved to the first matching place. Paginates through Google's reviews feed until max_results. Each row carries 16 fields, listed in full on this page.

What do I send it?

A semantic input rather than a URL list. One run returns up to 100 reviews.

How much does the Place reviews API cost?

$0.0005 per delivered review. A run that delivers nothing is not billed, and the