ToolzerHub Docs

Get hotel reviews (v1)

Returns one page of 25 guest reviews for a hotel, newest or by score, with what guests liked and disliked, scores out of 10 and traveler type. A hotel without reviews returns empty reviews.

1 credit / requestBilled only on success
GET
/v1/priceline/reviews

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

hotel*string

hotel_id from a search result, or a priceline.com hotel link such as https://www.priceline.com/relax/at/291003.

Lengthlength <= 1000
sort?string

recent (newest first), highest or lowest score.

Default"recent"

Value in

  • "recent"
  • "highest"
  • "lowest"
page?integer

One-based page of 25 reviews, up to total_pages.

Range1 <= value <= 400
Default1
curl -X GET "https://example.com/v1/priceline/reviews?hotel=291003" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "hotel_id": "291003",    "sort": "recent",    "page": 0,    "page_size": 25,    "total_pages": 10,    "has_more": true,    "review_score": 8.1,    "review_score_scale_max": 10,    "review_count": 525,    "reachable_reviews": 230,    "subscores": [      {        "type": "CLEANLINESS",        "label": "Cleanliness",        "score": 8.2      }    ],    "count": 0,    "reviews": [      {        "review_id": "5356707708",        "date": "Oct 2026",        "title": "Good place to stay",        "liked": "string",        "disliked": "string",        "score": 8,        "subscores": [          {            "type": "CLEANLINESS",            "label": "Cleanliness",            "score": 8.2          }        ],        "author": {          "name": "Waleed",          "country_code": "SA",          "traveler_type": "Family with Young Children"        }      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}