Trip.com Hotel Reviews API
Extract comprehensive hotel reviews from Trip.com with detailed ratings, guest feedback, and filter options for sentiment analysis.
Overview
Multi-Provider Reviews
Trip.com aggregates reviews from multiple sources including TripAdvisor and Expedia, providing a comprehensive view of guest feedback.
The Trip.com Hotel Reviews endpoint provides access to comprehensive review data including guest ratings, detailed comments, check-in dates, and sentiment filters. Reviews can be filtered by positive, negative, or those with photos/videos.
Endpoint URL
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| hotel_id | integer | Required | Trip.com hotel ID (path parameter, e.g., 702258) |
| page | integer | Optional | Page number for pagination (starts at 1, default: 1) |
| page_size | integer | Optional | Number of reviews per page (default: 10, max: 50) |
| currency | string | Optional | Currency code (default: USD) |
| locale | string | Optional | Locale string (default: en-XX) |
Response Format
Success Response
Returns a JSON object containing reviews array, total count, and available filters.
{
"success": true,
"hotel_id": 702258,
"data": {
"total_reviews": 919,
"reviews": [...],
"filterList": [...],
"imageDomain": "ak-d.tripcdn.com"
},
"retrieved_at": "2025-01-23T12:00:00Z"
}
Review Object Structure
Core Fields
id- Review identifier from Trip.comrating- Review score (1-10 scale)title- Rating label (e.g., "Very good", "Great")text- Full review textdate- Review creation datestay_date- Guest's check-in datereviewer_name- Guest nameroom_type- Room type bookedtravel_type- Trip type (e.g., "Business traveler", "Family")images- Array of review image URLs
Filter List Object
id- Filter identifiername- Filter name (e.g., "Positive reviews", "Negative reviews")commentCount- Number of reviews matching filterfilterType- Type of filter (1 = sentiment, 2 = category)
Error Responses
Bad Request
Invalid hotel ID or parameter values
Unauthorized
Missing or invalid API key
Internal Server Error
Failed to fetch reviews from Trip.com
Usage Tips
Pagination Info
Use page_size up to 50 reviews per request. Calculate total pages by dividing total_reviews by page_size.
Best Practices
- Start with page 1 and increment sequentially for pagination
- Use the filterList to understand review sentiment distribution
- Monitor the total_reviews field to know when to stop paginating
- Cache review data as it doesn't change frequently
- Reviews include data from multiple providers (Trip.com, TripAdvisor, Expedia)
- Use page_size=50 for fewer API calls when fetching all reviews