google_maps_reviews
Retrieve customer reviews for any Google Maps location using its data ID. Filter by sorting, language, or topic, and paginate through results.
Instructions
Retrieves customer reviews for a Google Maps location, with sorting and topic filtering, given a Maps data_id. [Credits: Not explicitly stated on this page (see general Scrapingdog credit pricing).] Notes: topic_id values come from the topics array in a previous response (each topic has a keyword, mentions count, and id). The results param has an exception: on an unfiltered first page (no next_page_token and no topic_id) it is ignored and 8 results are returned. Pagination is cursor-based via next_page_token; response includes a ready-made pagination.next URL. Returns: JSON with locationDetails {title, address, rating, total_reviews}, topics array of {keyword, mentions, id}, reviews_results array of {rating, date, snippet, user {name, reviews, thumbnail}, images[]}, and pagination {next_page_token, next (full next-page URL)}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data_id | Yes | The Google Maps data ID for the location, obtained from the google_maps_search endpoint (or its returned reviews_link). | |
| results | No | Maximum number of results to return. Valid range: 1-20. Cannot be used on the first page without also supplying next_page_token or topic_id — in that case the response will contain 8 results regardless. (default: 10) | |
| sort_by | No | Sort order for reviews. Allowed values: `qualityScore` (most relevant, default), `newestFirst` (most recent), `ratingHigh` (highest rated), `ratingLow` (lowest rated). (default: qualityScore) | |
| language | No | Language of the results (e.g. en, es, fr, de). See Google Language Page documentation for full list. (default: en) | |
| topic_id | No | ID of a review topic to filter by, taken from the `topics` array returned in a prior response of this endpoint. | |
| next_page_token | No | Token used to fetch the next page of review results. |