Agoda Review Comments API
Access provider-specific hotel reviews from Agoda or partner platforms with granular control over the review source.
Overview
Provider-Specific Reviews
Filter reviews by specific providers like Agoda (3038) or aggregated sources (332) for targeted sentiment analysis.
The Review Comments endpoint provides access to reviews from specific review providers, allowing you to filter and analyze feedback from individual platforms. This is useful when you need to focus on reviews from a particular source or compare sentiment across different platforms.
Endpoint URL
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| hotel_id | integer | Required | Agoda hotel ID (path parameter) |
| page | integer | Optional | Page number for pagination (starts at 1, default: 1) |
| provider_id | integer | Optional | Review provider ID (3038 = Agoda reviews, default: 3038) |
| sorting | integer | Optional | Sort order: 7 = most recent, 6 = highest rating, 5 = lowest rating (default: 7) |
Provider IDs
Common Review Providers
Provider IDs allow filtering reviews by their source platform. Use 3038 for Agoda's own reviews.
Response Format
Success Response
Returns provider-specific reviews with detailed pagination information.
{
"success": true,
"hotel_id": 319457,
"reviews": [...],
"pagination": {
"current_page": 1,
"page_size": 20,
"total_count": 565,
"total_pages": 113
},
"retrieved_at": "2025-09-04T10:30:00Z"
}
Provider-Specific Counts
Total review counts will vary by provider. Agoda (3038) may have different totals than aggregated sources.
Usage Examples
Get Agoda-Only Reviews
Fetch reviews submitted directly on Agoda platform:
Get Highest Rated Reviews
Fetch top-rated reviews for showcasing positive feedback:
Paginate Through All Reviews
Iterate through pages to collect all reviews (20 per page):
Best Practices
Optimization Tips
- Use specific provider IDs to reduce response size and processing time
- Implement pagination to fetch all reviews (20 per page)
- Cache reviews by provider_id as they change less frequently than aggregated data
- Use sorting=6 to highlight positive reviews in your application
- Monitor pagination.total_pages to optimize your fetching strategy
- Consider fetching from multiple providers in parallel for comparison
Provider Comparison
Fetch reviews from different providers separately to compare sentiment and identify platform-specific trends.