Hotel Reviews

2 credits

Get guest reviews for a hotel with sorting and search filters.

POST/api/v1/tools/google/hotels/reviews

Parameters

hotelUrlstring

Google Hotels URL containing /entity/ token. Either hotelUrl or propertyId required.

propertyIdstring

Booking token from search results. Either hotelUrl or propertyId required.

sortstring

"most_helpful", "most_recent", "highest_score", "lowest_score". Defaults to "most_helpful".

searchstring

Search within reviews.

maxReviewsnumber

Max reviews. Defaults to 40.

fieldsstring[]

Fields to include in response. Omit or pass ["*"] for all fields.

Response Schema

dataobject

Google Hotels reviews result

reviewsobject[]

Array of guest reviews

countnumber

Total number of reviews returned

metaobject

Request metadata

toolstring

Tool name (google-hotels-reviews)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/hotels/reviews \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "propertyId": "ChYIq_X...",
    "sort": "most_recent",
    "maxReviews": 20
  }'

Response Example

{
  "data": {
    "reviews": [
      {
        "author": "Marie L.",
        "rating": 5,
        "text": "Wonderful location in the heart of Paris. The staff was incredibly helpful and the rooms were spotless.",
        "timestamp": 1717200000,
        "language": "en",
        "source": "Google"
      },
      {
        "author": "James K.",
        "rating": 4,
        "text": "Great hotel with a charming atmosphere. Breakfast could be better but overall a pleasant stay.",
        "timestamp": 1716940800,
        "language": "en",
        "source": "Booking.com"
      }
    ],
    "count": 2
  },
  "meta": {
    "tool": "google-hotels-reviews",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}

curl -X POST https://scraper.run/api/v1/tools/google/hotels/reviews \

-H "Authorization: Bearer sc_live_..." \

-H "Content-Type: application/json" \

-d '{

"propertyId": "ChYIq_X...",

"sort": "most_recent",

"maxReviews": 20

{

"data": {

"reviews": [

{

"author": "Marie L.",

"rating": 5,

"text": "Wonderful location in the heart of Paris. The staff was incredibly helpful and the rooms were spotless.",

"timestamp": 1717200000,

"language": "en",

"source": "Google"

{

"author": "James K.",

"rating": 4,

"text": "Great hotel with a charming atmosphere. Breakfast could be better but overall a pleasant stay.",

"timestamp": 1716940800,

"language": "en",

"source": "Booking.com"

}

"count": 2

"meta": {

"tool": "google-hotels-reviews",

"creditsUsed": 2,

"requestId": "req_abc123"

}