Agoda Hotel Reviews API Documentation Retrieve guest reviews of one Agoda hotel, about 40 per page from Agoda and Booking.com: for each review the id, source, rating, rating text, title, comment, positives, negatives, review date (ISO 8601, UTC), stay dates, reviewer name and country, traveler type, room type and the hotel response. Sort by recent, rating_high, rating_low or helpful. A page past the last one is a successful empty response.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
integer
Required
Agoda hotel id from the suggest or search endpoint. Example: 44842960.
1234567890
integer
Optional
Page number starting at 1. Defaults to 1.
1
string
Optional
One of recent, rating_high, rating_low or helpful. Defaults to recent.
relevance
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"sort": "recent",
"reviews": [
{
"id": 1193390977,
"title": "Excellent hotel",
"nights": 2,
"rating": 10,
"source": "Agoda",
"comment": "This is my favourite hotel in Bangkok. It is so beautiful in every way and staying 2 nights in the luxurious premium king room was an amazing experience with the Japanese toilet, full window view of the city, complimentary snacks and drinks and super comfortable bed. Breakfast buffet had lots of western and Asian choices with an egg station, and a big salad and fruit area. The espresso machine made the best coffee I\u2019ve had in any hotel breakfast. Free shuttle for guests to a BTS station conveniently operate on a regular basis. I had a delicious and elegant Chinese lunch with my friend at the Hua restaurant.",
"check_in": "2026-10-07",
"check_out": "2026-10-09",
"room_type": "Deluxe King Room",
"rating_text": "Exceptional",
"reviewed_at": "2026-10-09T18:25:56Z",
"host_response": "Dear Ms. Rachel,\n\nGreetings from Grande Centre Point Surawong Bangkok.\n\nThank you very much for your wonderful review and continued appreciation of our hotel. We are delighted to know that you enjoyed your luxurious Premium King Room, city views, comfortable bed, complimentary minibar, and modern amenities.\n\nIt is also a pleasure to hear that our breakfast selection, freshly prepared coffee, complimentary BTS shuttle service, and elegant Chinese lunch at Hua Restaurant made your stay even more memorable. Your kind words mean a great deal to our entire team.\n\nGrande regards,\n\nAnongnuch S.\nAssistant Front Office Manager",
"reviewer_name": "Rachel",
"traveler_type": "Solo traveler",
"reviewer_country": "Australia",
"host_responded_at": "2026-10-12T01:06:48Z"
},
{
"id": 1188000469,
"title": "Relaxing",
"rating": 10,
"source": "Booking.com",
"positives": "Good location, great hospitality and staff, amazing breakfast variety and selection and food quality",
"rating_text": "Exceptional",
"reviewed_at": "2026-09-26T17:00:00Z",
"reviewer_name": "Alessandro",
"traveler_type": "Group"
}
],
"has_more": true,
"hotel_id": 44842960,
"next_page": 2,
"hotel_name": "Grande Centre Point Surawong Bangkok"
},
"meta": {
"billable": true,
"endpoint_family": "hotel_reviews"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required query parameter is missing or invalid. This response is not billable.
{
"errors": {
"hotel_id": [
"The hotel id field is required."
]
},
"message": "The request validation failed"
}Resource Not Found
The hotel id is unknown to Agoda. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "hotel_reviews"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested Agoda resource was not found."
},
"success": false
}Service Unavailable
Agoda could not be reached or answered with an unexpected shape. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "hotel_reviews"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Agoda API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.