Table of contents
GeoScraper API Documentation - Google Map Review API
Google Map Review API
This endpoint enables you to scrape reviews of a single place from Google Maps.
Endpoint
- POST:
https://api.geoscraper.net/google/map/review
Headers
X-Berserker-Token:Your_Access_Token
Request Body
- Format: JSON
- Fields:
data_id(required): The unique identifier for the place.token(optional): Token for the next page (obtainable from the first page response).hl(optional): Language parameter to specify the response language.sort_by(optional): Sort by results, relevent, newest, highest_rating, lowest_ratingcatched(optional): Boolean to indicate if cached data should be used.
Sample Request
import requests
url = "https://api.geoscraper.net/google/map/review"
payload = {
"data_id": "ChIJlZKxsJUNTYgR0xdaamwAv8A",
"token": "CAESY0NBRVFDaHBFUTJwRlNVRlNTWEJEWjI5QlVEYzRTR28zUlVwU2QxOWZSV2hEUjBsNWMzRldjak00ZVVJMlUxUjJXVUZCUVVGQlIyZHVPVEl6WTBOa2NWWTVTazlGV1VGRFNVRQ==",
"hl": "en",
"sort_by":"lowest_rating",
"catched": true
}
headers = {'X-Berserker-Token': 'Your_Access_Token'}
response = requests.post(url, headers=headers, json=payload)
print(response.text)
Sample Response
[
{
"rating": 1,
"date": "5 days ago",
"source": "Google",
"review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tNMllWUkhWMU15ZWxFM2RqQnROMHhwWWkwM1lrRRAB",
"user": {
"name": "JC Cat",
"link": "https://www.google.com/maps/contrib/103568805474457258045?hl=en",
"contributor_id": 103568805474457258045,
"thumbnail": "https://lh3.googleusercontent.com/a/ACg8ocJyz4C51Yitc_kY8w6PTnnbbuM8CBeL104rmvTc1pygPPLjZA=s120-c-rp-mo-ba3-br100",
"local_guide_level": 5,
"reviews": 39,
"photos": 1
},
"snippet": "It is okay, but house keeping comes and knocks on your door very early. Don't expect to sleep in if you stay here. Parking is a hassle as well.",
"reviewContext": [
{
"aspects": [
"HOTELS_PILOT_TRIP_TYPE"
],
"name": "What kind of trip was it?",
"rating": null
},
{
"aspects": [
"HOTELS_PILOT_TRAVEL_GROUP_TYPE"
],
"name": "Who did you travel with?",
"rating": null
},
{
"aspects": [
"HOTELS_ASPECT_ROOMS"
],
"name": "Rooms",
"rating": 3
},
{
"aspects": [
"HOTELS_ASPECT_SERVICES"
],
"name": "Service",
"rating": 2
}
],
"publishedAtDate": "2025-07-05 13:15:23",
"lastEditedAtDate": "2025-07-05 13:23:43",
"publishedAtDate_timestamp": 1751721323504593,
"lastEditedAtDate_timestamp": 1751721823700326,
"details": {
"mode": "Vacation",
"meal_type": "Family",
"food": 2,
"price_range": null,
"service": null,
"atmosphere": null,
"recommended_dish_one": null
},
"owner_response": {
"owner_response_text": "Hello JC, thank you for your feedback. We're sorry to hear about the challenges you faced with the timing of housekeeping and parking. Your concerns are being looked into. Please contact https://help.hilton.com/s/contactsupport or call (540) 400-6000 for further discussion. We hope to welcome you again at Hampton Inn & Suites Roanoke-Downtown.",
"owner_response_date_timestamp": 1751902509000000,
"owner_response_edited_date_timestamp": 1751902509000000,
"owner_response_date": "2025-07-07 15:35:09",
"owner_response_edited_date": "2025-07-07 15:35:09",
"owner_response_translated_text": null
},
"images": null,
"translated_snippet": null
},
{
"rating": 1,
"date": "10 months ago",
"images": [
"https://lh3.googleusercontent.com/geougc-cs/AB3l90C0B9k1CTRH4Z_fF3juyXt5_-4bgvwX8YcBiVE_pjpVRcuWln0FPsq3vFSMN-GOpv6G3wpsEYRKu4jvjHWwMvwe1YBI8zX_lv26rj1d2uTjao7TaX72xG-6nikyZqI9MrxOooY_Vw"
],
"source": "Google",
"review_id": "ChZDSUhNMG9nS0VJQ0FnSUQ3ajdPNFV3EAE",
"user": {
"name": "lance cannon",
"link": "https://www.google.com/maps/contrib/115678039682988662420?hl=en",
"contributor_id": 115678039682988662420,
"thumbnail": "https://lh3.googleusercontent.com/a/ACg8ocLLDZi7V_K1299MEr9oBQKrkwh0hmIZA9ROnTs41t0kEBLfdA=s120-c-rp-mo-ba3-br100",
"local_guide_level": 5,
"reviews": 51,
"photos": 22
},
"snippet": "I upgraded my room to a balcony. Right when we got into our room we could see that it was not clean. I checked the balcony and it was filthy and covered in bird poop. The room had bugs, tons of wear, torn carpet, and even a hole in the boxspring. We had housekeeping come up and check the issues and was told it is what it is. They said they would not clean the bugs or any of the issues because the hotel is only 8 years old and not scheduled for refurbishments for another 2 years. I was dumbfounded. I we t down to speak with the front desk lady who seem annoyed that housekeeping could not help. I ask for another room and she said she would just cancel our reservation because they were sold out. I agreed and we left. Now we had no where to stay until I found another hotel a few hours away. Terrible all around.",
"reviewContext": [
{
"aspects": [
"HOTELS_PILOT_TRIP_TYPE"
],
"name": "What kind of trip was it?",
"rating": null
},
{
"aspects": [
"HOTELS_PILOT_TRAVEL_GROUP_TYPE"
],
"name": "Who did you travel with?",
"rating": null
},
{
"aspects": [
"HOTELS_ASPECT_ROOMS"
],
"name": "Rooms",
"rating": 1
},
{
"aspects": [
"HOTELS_ASPECT_SERVICES"
],
"name": "Service",
"rating": 1
},
{
"aspects": [
"HOTELS_ASPECT_LOCATION"
],
"name": "Location",
"rating": 4
}
],
"publishedAtDate": "2024-08-29 23:43:57",
"lastEditedAtDate": "2024-08-29 23:43:57",
"publishedAtDate_timestamp": 1724975037516480,
"lastEditedAtDate_timestamp": 1724975037516480,
"details": {
"mode": "Vacation",
"meal_type": "Family",
"food": 1,
"service": 4,
"price_range": null,
"atmosphere": null,
"recommended_dish_one": null
},
"owner_response": {
"owner_response_text": null,
"owner_response_translated_text": null,
"owner_response_date_timestamp": null,
"owner_response_edited_date_timestamp": null,
"owner_response_date": null,
"owner_response_edited_date": null
},
"translated_snippet": null
},
{
"rating": 1,
"date": "a year ago",
"images": [
"https://lh3.googleusercontent.com/geougc-cs/AB3l90Du7K6kk7mX7QA1r_3GdMrNB0dclBY_ur0XBMigcUjbT2nPqANx8EtNjmg1wSoKWgkYy4Y8tUbXwetRCQUsMvNRrddWQMbqNnKBhseTwL7P4Oa7J0xC3z3gS4_H0wvr86mwD5Xv"
],
"source": "Google",
"review_id": "ChdDSUhNMG9nS0VJQ0FnSUQ5a2ZXYmlnRRAB",
"user": {
"name": "Sal Inzone",
"link": "https://www.google.com/maps/contrib/108843947316762579036?hl=en",
"contributor_id": 108843947316762579036,
"thumbnail": "https://lh3.googleusercontent.com/a/ACg8ocIuD9SUIXRZBaFDH8pXiepDxIRDZxaU8RFOHdOheuXH1tkFgUA=s120-c-rp-mo-ba4-br100",
"local_guide_level": 6,
"reviews": 142,
"photos": 56
},
"snippet": "Let's start with the confusion of the garage. The garage requires a hotel key, however you need to take a ticket first if you haven't checked-in which does not make it very clear.\nThe manager was extremly rude, right from the beginning. She didn't mention that you need a hotel key for the stairwell, so I got stuck in the stairwell unable to get in the hotel. I called and called and was on hotel for 8 minutes!\n\nMy room was dirty. I'm a male with short (.25\") cut hair. There was long female hair on the TV stand, dirt on the bathroom floor & shower and clothing tag attachments on the floor. It shows they didn't vacuum. They did not provide enough towels either.",
"reviewContext": [
{
"aspects": [
"HOTELS_PILOT_TRIP_TYPE"
],
"name": "What kind of trip was it?",
"rating": null
},
{
"aspects": [
"HOTELS_PILOT_TRAVEL_GROUP_TYPE"
],
"name": "Who did you travel with?",
"rating": null
},
{
"aspects": [
"HOTELS_ASPECT_ROOMS"
],
"name": "Rooms",
"rating": 4
},
{
"aspects": [
"HOTELS_ASPECT_SERVICES"
],
"name": "Service",
"rating": 2
},
{
"aspects": [
"HOTELS_ASPECT_LOCATION"
],
"name": "Location",
"rating": 4
}
],
"publishedAtDate": "2024-03-17 20:15:50",
"lastEditedAtDate": "2024-03-17 20:15:50",
"publishedAtDate_timestamp": 1710706550688387,
"lastEditedAtDate_timestamp": 1710706550688387,
"details": {
"mode": "Business",
"meal_type": "Solo",
"food": 2,
"service": 4,
"price_range": null,
"atmosphere": null,
"recommended_dish_one": null
},
"owner_response": {
"owner_response_text": "Hi Sal - We are sorry for the challenges you encountered during your stay. We strive to provide our guests with a clean, comfortable environment and a seamless experience, but we missed the mark. We want to look into these issues you mentioned and use this review to improve our service. Please feel free to contact us at https://help.hilton.com/s/contactsupport or call our team at (540) 400-6000 so we can follow up with you. Thanks for taking the time to leave us feedback.",
"owner_response_date_timestamp": 1710942082000000,
"owner_response_edited_date_timestamp": 1710942082000000,
"owner_response_date": "2024-03-20 13:41:22",
"owner_response_edited_date": "2024-03-20 13:41:22",
"owner_response_translated_text": null
},
"translated_snippet": null
},
{
"rating": 1,
"date": "3 months ago",
"source": "Google",
"review_id": "ChZDSUhNMG9nS0VJQ0FnTUNJa0pHVFN3EAE",
"user": {
"name": "Susan Green",
"link": "https://www.google.com/maps/contrib/107328380757861279172?hl=en",
"contributor_id": 107328380757861279172,
"thumbnail": "https://lh3.googleusercontent.com/a/ACg8ocLOtB-XxSVQWwhnlXF-g2m7YMTz6kmIAYbsxxw18ZgiOeIWzg=s120-c-rp-mo-br100",
"reviews": 1,
"photos": 0,
"local_guide_level": null
},
"snippet": "Don't stay here. Question you as soon as you walk into lobby. Won't even let guests use restroom.",
"publishedAtDate": "2025-03-29 15:33:01",
"lastEditedAtDate": "2025-03-29 15:33:01",
"publishedAtDate_timestamp": 1743262381630486,
"lastEditedAtDate_timestamp": 1743262381630486,
"details": {
"mode": null,
"meal_type": null,
"price_range": null,
"food": null,
"service": null,
"atmosphere": null,
"recommended_dish_one": null
},
"owner_response": {
"owner_response_text": "Good morning Susan,\n\nI apologize as though you felt we wouldn't permit our guests to use the restroom as that is not the case at all! I wasn't able to locate a reservation under your name. Please give me a call at 540-400-6000 so that we can make things right!\n\nSincerely,\nKaity Burkhart\nAssistant General Manager",
"owner_response_date_timestamp": 1743432970000000,
"owner_response_edited_date_timestamp": 1743519075000000,
"owner_response_date": "2025-03-31 14:56:10",
"owner_response_edited_date": "2025-04-01 14:51:15",
"owner_response_translated_text": null
},
"reviewContext": null,
"images": null,
"translated_snippet": null
},
{
"rating": 1,
"date": "11 months ago",
"source": "Google",
"review_id": "ChdDSUhNMG9nS0VJQ0FnSURyci1uM21BRRAB",
"user": {
"name": "James Whitlock (whiplash6310)",
"link": "https://www.google.com/maps/contrib/117698584729058196976?hl=en",
"contributor_id": 117698584729058196976,
"thumbnail": "https://lh3.googleusercontent.com/a-/ALV-UjU6LuDqjEOZcGaY7UG0AvJMBvFQl7DOGmdeVlgy3NoHuDaBqXfxhw=s120-c-rp-mo-ba3-br100",
"local_guide_level": 5,
"reviews": 25,
"photos": 0
},
"snippet": "Absolute joke of a hotel. 8:30am on Sunday and no breakfast, no coffee. Staff are the most unprofessional I've ever seen. Bathtubs are grimy, caulking is gross. Not worth the money at all.\n\nEdit: front desk is \"doing it all\" but just went for a smoke break",
"publishedAtDate": "2024-07-21 12:35:09",
"lastEditedAtDate": "2024-07-21 12:42:09",
"publishedAtDate_timestamp": 1721565309975746,
"lastEditedAtDate_timestamp": 1721565729619536,
"details": {
"mode": null,
"meal_type": null,
"price_range": null,
"food": null,
"service": null,
"atmosphere": null,
"recommended_dish_one": null
},
"owner_response": {
"owner_response_text": "Hi James, we value our guests and always strive to deliver exceptional service and outstanding accommodations, so we're sorry we fell short. We would like the opportunity to look into this further. Could you please contact us at https://help.hilton.com/s/contactsupport or call our team at (540) 400-6000? Thank you for taking the time to leave us a review.",
"owner_response_date_timestamp": 1721745568000000,
"owner_response_edited_date_timestamp": 1721745568000000,
"owner_response_date": "2024-07-23 14:39:28",
"owner_response_edited_date": "2024-07-23 14:39:28",
"owner_response_translated_text": null
},
"reviewContext": null,
"images": null,
"translated_snippet": null
},
{
"rating": 1,
"date": "2 years ago",
"source": "Google",
"review_id": "ChZDSUhNMG9nS0VJQ0FnSURSMjVLbElBEAE",
"user": {
"name": "Brian",
"link": "https://www.google.com/maps/contrib/112574117329076362027?hl=en",
"contributor_id": 112574117329076362027,
"thumbnail": "https://lh3.googleusercontent.com/a-/ALV-UjXMJLQTm4NfFLYOz-5U1_ScZIJihGkyPefSZs3YVGhpOJfagTF2=s120-c-rp-mo-ba2-br100",
"local_guide_level": 4,
"reviews": 16,
"photos": 0
},
"snippet": "I generally don't write reviews unless I have a really good or bad experience. This was the latter. To keep it short:\n\nThe front desk had to manually check if rooms were ready to go, leaving my standing in the lobby for 10 minutes (had a reservation) while the front desk girl kept yawning as I stood next to her. I don't know, it was very weird.\n\nThere were pubic hairs in the bathtub (obviously not cleaned).\n\nNo remote in room (?)\n\nPhone in room did NOT work.\n\nOJ in the AM was watered down, bagel stale.\n\nYour mileage may vary, but if I'm paying $200+ a night, I expect a bit better. The hotel currently has a 4.4 rating which kind of blows my mind. Wouldn't recommend staying here if there's other options.",
"reviewContext": [
{
"aspects": [
"HOTELS_PILOT_TRIP_TYPE"
],
"name": "What kind of trip was it?",
"rating": null
},
{
"aspects": [
"HOTELS_ASPECT_ROOMS"
],
"name": "Rooms",
"rating": 1
},
{
"aspects": [
"HOTELS_ASPECT_SERVICES"
],
"name": "Service",
"rating": 1
},
{
"aspects": [
"HOTELS_ASPECT_LOCATION"
],
"name": "Location",
"rating": 4
}
],
"publishedAtDate": "2023-05-04 13:35:50",
"lastEditedAtDate": "2023-05-04 14:26:44",
"publishedAtDate_timestamp": 1683207350324645,
"lastEditedAtDate_timestamp": 1683210404445401,
"details": {
"mode": "Vacation",
"food": 4,
"meal_type": null,
"price_range": null,
"service": null,
"atmosphere": null,
"recommended_dish_one": null
},
"owner_response": {
"owner_response_text": "We are sorry to hear we didn't fully meet your expectations, Brian. We set a high standard for our hotel, and it's disappointing to miss the mark during your visit. We are looking into these issues and hope to resolve them promptly. Please contact us at https://help.hilton.com/s/contactsupport or call our team at (540) 400-6000 so we can follow up with you. Thank you for taking the time to leave.",
"owner_response_date_timestamp": 1683387804000000,
"owner_response_edited_date_timestamp": 1683387804000000,
"owner_response_date": "2023-05-06 15:43:24",
"owner_response_edited_date": "2023-05-06 15:43:24",
"owner_response_translated_text": null
},
"images": null,
"translated_snippet": null
},
{
"rating": 1,
"date": "a year ago",
"source": "Google",
"review_id": "ChdDSUhNMG9nS0VJQ0FnSURKLXRfTWtBRRAB",
"user": {
"name": "RJ Grudeski",
"link": "https://www.google.com/maps/contrib/102839065709738966665?hl=en",
"contributor_id": 102839065709738966665,
"thumbnail": "https://lh3.googleusercontent.com/a/ACg8ocInXnPAz0NynBX61VaPa7FrL2f3q3cx9psPfffCnFdt0l76OA=s120-c-rp-mo-br100",
"local_guide_level": 3,
"reviews": 9,
"photos": 1
},
"snippet": "I would not recommend this hotel to ANYONE. I am a diamond member with Hilton saying this. Everything in Roanoke is less than a 10 min distance please stay elsewhere.\n\nWe had requested room service daily and confirmed this with the front desk staff. We had stayed for several nights and only received it on the fourth day. We had gone down a total of five times throughout our stay to confirm daily service and that was never upheld. It wasn’t just one particular staff member, we dealt with three different individuals and it was never fixed.\n\nTo go along with this, their “business center” is not that at all. They have a broken laptop with a printer in their lobby. When I asked about printing apparently the printer is not operable. But the one in the back was! And conveniently it’s a ten dollar usage fee for doing so. Very convenient that the printer in the “business center” was down, and it would be a charge to print anything. I have stayed in several hiltons being a diamond member and I have NEVER been charged for printing and they were always in color. Of course ours was in black and white.\n\nFurthermore, the staff we have encountered were so miserable. No one would greet you when you were leaving or entering. This is unlike any Hilton I have stayed in. You could audibly hear their conversations being held in the back office while there are multiple people attempting to check in. If you didn’t yell for their attention, or wait almost ten minutes, no one was going to come out and assist your needs.\n\nI had tried to rectify my situation with front desk and were told I would receive points onto my account. That does not make up for the worst stay I have had in ANY hotel. It’s not hard to have an operating printer, room service, or a staff with some hospitality.",
"reviewContext": [
{
"aspects": [
"HOTELS_PILOT_TRIP_TYPE"
],
"name": "What kind of trip was it?",
"rating": null
},
{
"aspects": [
"HOTELS_PILOT_TRAVEL_GROUP_TYPE"
],
"name": "Who did you travel with?",
"rating": null
},
{
"aspects": [
"HOTELS_ASPECT_ROOMS"
],
"name": "Rooms",
"rating": 1
},
{
"aspects": [
"HOTELS_ASPECT_SERVICES"
],
"name": "Service",
"rating": 1
},
{
"aspects": [
"HOTELS_ASPECT_LOCATION"
],
"name": "Location",
"rating": 1
}
],
"publishedAtDate": "2023-07-15 17:04:32",
"lastEditedAtDate": "2023-07-15 17:04:32",
"publishedAtDate_timestamp": 1689440672542491,
"lastEditedAtDate_timestamp": 1689440672542491,
"details": {
"mode": "Business",
"meal_type": "Solo",
"food": 1,
"service": 1,
"price_range": null,
"atmosphere": null,
"recommended_dish_one": null
},
"owner_response": {
"owner_response_text": "Hi RJ Grudeski, as a valued Diamond member, we appreciate your loyalty to the Hilton brand. We apologize for the issues you experienced during your stay, including the lack of daily room service and the inconvenience with our business center. We understand how important these amenities are for a comfortable stay. Rest assured, we take your concerns seriously and we are looking into the issues you mentioned. If you would like to further discuss your experience, please reach out to our customer support team at https://help.hilton.com/s/contactsupport or call (540) 400-6000. They will be happy to assist you. We appreciate your feedback and hope to have the opportunity to welcome you back in the future for a more enjoyable stay.",
"owner_response_date_timestamp": 1689626740000000,
"owner_response_edited_date_timestamp": 1689626740000000,
"owner_response_date": "2023-07-17 20:45:40",
"owner_response_edited_date": "2023-07-17 20:45:40",
"owner_response_translated_text": null
},
"images": null,
"translated_snippet": null
},
{
"next_page_token": "CAESY0NBRVFDaHBFUTJwRlNVRlNTWEJEWjI5QlVEYzRTR28zUlVwU2QxOWZSV2hEUjBsNWMzRldjak00ZVVJMlUxUjJXVUZCUVVGQlIyZHVPVEl6WTBOa2NWWTVTazlGV1VGRFNVRQ=="
}
]
Description
- The response includes a list of reviews for the specified place. Each review contains details like the rating, date, user information, and the review text. The
next_page_tokencan be used to paginate through additional reviews.
Note: Replace Your_Access_Token with your actual API access token.