Pricing

Rating

Developer

Actor stats

Categories

Share

⚡ Want a higher maximum, faster results and Review direct links? Please use canadesk/google-places-reviews-plus!

⭐ The actor works with all Places. This includes monuments, hotels, restaurants, etc.

Input

• Places (array)

  List of places to fetch reviews for. The following types are accepted:

  • Search Terms: chateau de versailles france

  • Share link (⚡ Recommended!): https://maps.app.goo.gl/WQLepEgAgPCCtqot7

  • Full Place link: https://www.google.com/maps/place/Disneyland+Park/@33.8120962,-117.9215491,17z/data=!4m8!3m7!1s0x80dcd7d12b3b5e6b:0x2ef62f8418225cfa!8m2!3d33.8120918!4d-117.9189742!9m1!1b1!16zL20vMDJmenM

  When using search terms, make sure to be specific enough and include the country. Otherwise, you may get reviews for a different place.

• Data type (select)

  • Reviews: Returns reviews for the place.

  • Details: Returns details about the place, similar to the Information panel available on Google Maps.

• Search filter (string)

  Similar to the "Search reviews" option in the Reviews tab on Google Maps.

  Note that Google Maps does not support exact search.

• Language (string)

  Returns only reviews written in a specific language. Must be ISO 639-1, such as "en" or "es".

  Set to "all" to collect all languages. The filter is applied after collection!

• Date filter (array)

  The array must always have two entries, and at least one must not be empty.

  Examples:

  • Between two dates: ["2024-12-01", "2024-12-15"]

  • After a date: ["2024-12-01", ""]

  • Before a date: ["", "2024-12-15"]

  The filter is applied after collection!

• Country (string)

  Must be ISO 3166, such as "us".

• Sort By (select)

  Similar to the sorting in Google Maps.

  "Most Likes" is applied after collection!

• Reply filter (select)

  Returns All Reviews, Only reviews with replies or Only reviews without replies.

  The filter is applied after collection!

• Source filter (string)

  Returns only reviews from a specific source.

  For example, "trip" will match "Tripadvisor.com" and "Trip.com".

  The filter is applied after collection!

• User Latitude/Longitude (string)

  Optional. May help narrow down locations during search.

• Maximum (integer)

  Stops collection once this number is reached.

  For a higher maximum, please use the actor canadesk/google-places-reviews-plus instead.

• Delay (integer)

  Waiting time between requests. The lower, the higher the chances to get blocked.

Ouput

Reviews returns:

The field "location" is only populated when the Place is using search terms (id, name, address, coordinates).

{
"url":"https://www.google.com/maps/place/Empire+State+Building/@40.7484405,-73.9882393,17z/data=!3m1!5s0x8b398fecd1aea119:0x76fa1e3ac5a94c70!4m8!3m7!1s0x89c259a9b3117469:0xd134e199a405a163!8m2!3d40.7484405!4d-73.9856644!9m1!1b1!16zL20vMDJuZF8?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
"location":null,
"reviews":[
{
"id":"ChdDSUhNMG9nS0VJQ0FnSUNIeTRQVXlnRRAB",
"publishedAt":"2024-09-08T23:05:34",
"updatedAt":"2024-09-08T23:05:34",
"rating":4,
"review":"My visit to the Empire State Building was an unforgettable experience. From the moment I entered the iconic building, I was struck by its grandeur and historical significance. The Art Deco architecture is stunning, and the lobby itself is a sight to behold.\nThe elevator ride to the observation deck was smooth and quick, and the staff were friendly and efficient. Once at the top, the views were absolutely breathtaking. Seeing New York City from such a height is truly awe-inspiring. The 360-degree panorama allows you to take in all the major landmarks, from Central Park to the Statue of Liberty.\nThe exhibits on the way up were informative and added to the overall experience, providing interesting insights into the building’s history and construction. The binoculars on the observation deck were a fun addition, allowing for an even closer look at the city’s details.\nIn summary, the Empire State Building is a must-visit attraction in New York City. The combination of its historical charm, architectural beauty, and stunning views makes it an experience not to be missed.",
"language":"en",
"likes":4,
"reply":"Wow, Sacha, what a great review! We are forever grateful! Thank you so much for choosing to spend some of your NYC time with us and thank you for sharing your amazing photos! \n\nWe would love to get some feedback from you on what we could improve upon to have earned that full 5-star rating from you versus the 4-star rating. If you are willing to share your feedback, please email us at \"roomtoimprove@esbonyc.com\" to let us know what you think could have been better in order to get that 5-star ranking. We eagerly await to hear from you. Much appreciated! ",
"author":{
"name":"Sacha",
"avatar":"https://lh3.googleusercontent.com/a/ACg8ocKUMya57gW4Zx8X0fjx9LyKItsD9qdKhmKcDLVewizdEhysnw=s120-c-rp-mo-ba6-br100",
"url":"https://www.google.com/maps/contrib/105739057713241335266?hl=en",
"id":"105739057713241335266"
},
"images":[
{
"id":"AF1QipNzGVdB04NP5w0G1UNgqf14MMV7jjrtQXdvhzEk",
"url":"https://lh5.googleusercontent.com/p/AF1QipNzGVdB04NP5w0G1UNgqf14MMV7jjrtQXdvhzEk=w150-h150-k-no-p",
"size":{
"width":3024,
"height":4032
},
"location":"Empire State Building",
"caption":null
},
...
],
"url":"",// Only available with canadesk/google-places-reviews-plus
"source":"Google"
},
...
],
"count":10
}

Details returns:

The field "categoryDetails" depends on the category. For example, restaurants have a menu link, hotels have checkin/checkout times, etc.

{
"name":"Free Play Bar Arcade",
"description":"Playful watering hole for the 21+ crowd offering free classic arcade games, beer on tap & pizza.",
"link":"https://freeplaybar.com/",
"category":"Video arcade",
"categoryDetails":{
"menu":"https://freeplaybar.com/menu",
"reservation":"https://restaurent.com/venue/freeplay-providence/"
},
"location":{
"address":"Free Play Bar Arcade, 182 Pine St, Providence, RI 02903",
"localTimezone":"America/New_York",
"telephone":"+14013164299"
},
"reviewsSummary":{
"rating":4.7,
"count":2021
},
"timetable":[
{
"day":"Saturday",
"nextDate":"2024-12-14",
"hours":"5 PM–2 AM"
},
...
],
"tags":[
{
"tag":"drinks",
"count":112
},
...
],
"images":[
{
"title":"All",
"url":"https://lh5.googleusercontent.com/p/AF1QipOJIcFB7UBp4luzuGSUXlMh2MqVkUz31X93S7I5=w447-h298-k-no"
},
...
],
"about":[
{
"sectionName":"Accessibility",
"items":[
{
"id":"/geo/type/establishment_poi/has_wheelchair_accessible_entrance",
"name":"Wheelchair accessible entrance"
},
{
"id":"/geo/type/establishment_poi/has_wheelchair_accessible_restroom",
"name":"Wheelchair accessible restroom"
}
]
},
...
]
}

Support

Always use a strong proxy.

Open a new issue or contact support. Please share the Run URL and Input!

Cheers!