Google Place Reviews
Fetch structured reviews for a place — rating, text, author, date, and owner responses — with sorting and pagination. Get a data_id from the Maps endpoint.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsondata_idstringData ID (0xHEX:0xHEX), from a Maps result. Provide this or place_id.
Example: 0x8644ca6bc309e81b:0x1f1a903bbb66839
place_idstringPlace ID (ChIJ...). Provide this or data_id.
numnumberReviews per page (1-20).
next_page_tokenstringPagination cursor from a prior response.
sort_bystringdefault:relevanceReview order. Omit it for Google's default, most relevant first.
relevance— Most relevant first (Google's default).newest— Most recently posted or edited first. Orders by iso_date_of_last_edit, not iso_date.highest_rating— Highest star rating first.lowest_rating— Lowest star rating first. Use it to find critical reviews.
hlstringUI language.
Example: en
glstringGeo location country.
Example: us
Notes
Two dates per review. iso_date is when the review was first posted. iso_date_of_last_edit is when it was last edited, and it is the date the newest sort orders by; the human-readable date string ("Edited a day ago") follows it too. A review posted years ago and edited last week sorts as new but carries an old iso_date, so filter on iso_date_of_last_edit when you want recent activity.
Paging. Each response returns up to num reviews (max 20). Pass pagination.next_page_token back with the same sort_by to get the next page; when it is absent you have reached the end.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
results = client.google.maps_reviews(data_id="0x8644ca6bc309e81b:0x1f1a903bbb66839", sort_by="newest")
print(results)Response