Google Maps

Fetch Google Maps reviews

Returns reviews for one place identified by place_id or data_id; Google Maps responses include both, plus a ready-made reviews_link. Follow pagination.next to fetch more reviews.

get/api/google/reviews

Request

  • Base URL: https://api.litescrape.com
  • URL: https://api.litescrape.com/api/google/reviews
  • Auth: one of:
    • HTTP bearer
    • API key in header zc-signature

Query parameters

place_idstring
Example:ChIJT2h1HKZZwokR0kgzEtsa03k

Google Place ID. Exactly one of place_id or data_id is required.

data_idstring
Example:0x89c258e28c304997:0xfcafe4e7ce35ee8c

Hexadecimal Google Maps feature ID, such as the data_id in a Google Maps response. Exactly one of place_id or data_id is required.

hlstring
Example:en

Review language code such as en, en-GB, or de.

glstring
Example:us

Two-letter country code used to localize results, normalized to lowercase. Defaults to us.

sort_by'qualityScore' | 'newestFirst' | 'ratingHigh' | 'ratingLow'

Review order: qualityScore (most relevant), newestFirst, ratingHigh or ratingLow.

topic_idstring

Return only reviews about one topic. Use a topics[].id from a previous response. Mutually exclusive with query.

querystring
Example:parking

Free-text filter that returns reviews mentioning these words. Mutually exclusive with topic_id.

numinteger

Number of reviews to return. An initial unfiltered request returns 8 by default and accepts 1 through 100; requests with topic_id, query or next_page_token return 10 by default and accept 1 through 20.

next_page_tokenstring

Opaque token from a previous response. Send it with the same place, language, country, sort and filters, or follow pagination.next. Tokens expire after 30 minutes.

source_metadataboolean

Set to true to include each review source's icon and rating scale.

timeoutnumber

Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.

Response

Successful response; one call consumed unless noted otherwise.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.