ToolzerHub Docs

Get hotel reviews (v1)

Returns one page of guest reviews for a hotel: up to 20 from Agoda and 20 from Booking.com, each with its source, score out of 10, English text and the original, stay dates, room type and traveler type. A hotel without reviews returns empty reviews.

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

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

hotel*string

hotel_id from a search or locations result, or an agoda.com link that carries it, such as https://www.agoda.com/search?selectedproperty=10636.

Lengthlength <= 1000
sort?string

recent (newest first), highest or lowest score, or helpful (Agoda's default).

Default"recent"

Value in

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

One-based page, up to total_pages. Agoda serves pages 1 to 100 of each review source.

Range1 <= value <= 100
Default1
curl -X GET "https://example.com/v1/agoda/reviews?hotel=10636" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "hotel_id": "10636",    "sort": "recent",    "page": 0,    "page_size": 20,    "total_pages": 100,    "has_more": true,    "review_score": 8.3,    "review_score_scale_max": 10,    "review_count": 58187,    "subscores": [      {        "type": "cleanliness",        "label": "Cleanliness",        "score": 8.2      }    ],    "count": 0,    "reviews": [      {        "review_id": "1187182385",        "source": "Agoda",        "date": "2026-09-26T02:35:21+07:00",        "title": "Luxury hotel",        "text": "string",        "liked": "string",        "disliked": "string",        "score": 9.6,        "original_language": "ja",        "original_title": "string",        "original_text": "string",        "stay": {          "checkin": "2026-09-18",          "checkout": "2026-09-21",          "nights": 3,          "room_type": "Superior Twin Room - Non-Smoking"        },        "author": {          "name": "SANAE",          "country": "Japan",          "traveler_type": "Solo traveler"        }      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}