Agoda Hotel Reviews API
Extract comprehensive hotel reviews from Agoda with detailed ratings, guest profiles, and sentiment data from multiple review providers.
Overview
Multi-Provider Reviews
Access reviews from Agoda and partner platforms including Booking.com in a single API call with aggregated ratings.
The Agoda Hotel Reviews endpoint provides access to comprehensive review data including guest ratings, detailed comments, reviewer profiles, stay information, and sub-ratings for various hotel aspects. This endpoint aggregates reviews from multiple providers for a complete view of guest feedback.
Endpoint URL
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| hotel_id | integer | Required | Agoda hotel ID (path parameter, e.g., 319457) |
| page | integer | Optional | Page number for pagination (starts at 1, default: 1) |
| sorting | integer | Optional | Sort order: 7 = most recent, 6 = highest rating, 5 = lowest rating (default: 7) |
Response Format
Success Response
Returns a JSON object containing reviews array, pagination details, and hotel metadata.
{
"success": true,
"hotel_id": 319457,
"hotel_name": "Omena Hotel Jyvaskyla",
"reviews": [...],
"pagination": {
"current_page": 1,
"page_size": 20,
"total_count": 1459,
"total_pages": 73
},
"review_score": {
"overall": 7.9,
"score_text": "Very good",
"review_count": 1459
},
"retrieved_at": "2025-09-04T10:30:00Z"
}
Review Object Structure
Core Fields
review_id- Unique review identifierrating- Overall rating (1-10 scale)title- Review title/summarycomment- Full review textpros- Positive aspects mentionedcons- Negative aspects mentioneddate- Review submission datestay_date- Guest's stay dateroom_type- Room type bookedhelpful_count- Number of helpful voteslanguage- Review language code
Reviewer Object
name- Reviewer's display namecountry- Reviewer's countrylevel- Reviewer experience levelgroup_type- Travel group type (Solo, Couple, Family, etc.)
Sub-ratings Object
cleanliness- Cleanliness ratinglocation- Location ratingservice- Service quality ratingfacilities- Facilities ratingvalue_for_money- Value ratingcomfort- Comfort rating
Error Responses
Bad Request
Invalid hotel ID or parameter values
Unauthorized
Missing or invalid API key
Internal Server Error
Failed to fetch reviews from Agoda
Usage Tips
Pagination Info
Each page returns 20 reviews. Use the page parameter to navigate through all available reviews.
Best Practices
- Start with page 1 and increment sequentially for pagination
- Use sorting=7 for most recent reviews to get latest feedback
- Monitor the total_count in pagination to know when to stop
- Cache review data as it doesn't change frequently
- Combine with hotel details endpoint for complete property information
- Reviews include data from multiple providers (Agoda, Booking.com, etc.)
- Sub-ratings provide detailed insights into specific hotel aspects