// request reference
Google Maps Reviews parameters
Send query parameters with GET /api/google/reviews. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
The groups below list every request field, including compatibility restrictions. Read the extended reference for detailed types, defaults, parameter combinations and additional examples.
Place
Supply exactly one Google place identifier.
place_idGoogle Place ID.
Example / input hint: ChIJT2h1HKZZwokR0kgzEtsa03k
data_idHexadecimal Google Maps feature ID.
Example / input hint: 0x123:0x456
Sort & filter
Filter by either a review topic or a free-text query.
sort_byChoose Google’s review ordering.
qualityScore Most relevantnewestFirst NewestratingHigh Highest ratingratingLow Lowest ratingtopic_idMutually exclusive with query.
Example / input hint: /m/… or fused topic ID
queryFree-text review filter. Mutually exclusive with topic_id.
Example / input hint: parking
num1 through 100 initially; filtered and continuation requests accept up to 20.
Example / input hint: 10
Pagination
Continue from an opaque token returned by Litescrape.
next_page_tokenPreserves request-bound Reviews session context.
Example / input hint: Opaque token from the previous response
Localization & enrichment
Control locale and optional source metadata.
hlGoogle review language.
Example / input hint: en
glLowercase country localization.
Example / input hint: us
source_metadataInclude provider icon and rating-scale enrichment.
truefalse// response
Work with the complete JSON response
Response groups include reviews, place_info, topics, pagination. Groups and fields depend on the upstream result.
The SDK examples use raise_for_error() or raiseForError() so API errors are not mistaken for successful results.