GET

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

GET https://api.stayapi.com/v1/tripcom/hotel/reviews/{hotel_id}

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.com
  • rating - Review score (1-10 scale)
  • title - Rating label (e.g., "Very good", "Great")
  • text - Full review text
  • date - Review creation date
  • stay_date - Guest's check-in date
  • reviewer_name - Guest name
  • room_type - Room type booked
  • travel_type - Trip type (e.g., "Business traveler", "Family")
  • images - Array of review image URLs

Filter List Object

  • id - Filter identifier
  • name - Filter name (e.g., "Positive reviews", "Negative reviews")
  • commentCount - Number of reviews matching filter
  • filterType - Type of filter (1 = sentiment, 2 = category)

Error Responses

400

Bad Request

Invalid hotel ID or parameter values

401

Unauthorized

Missing or invalid API key

500

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
Request
curl -X GET "https://api.stayapi.com/v1/tripcom/hotel/reviews/702258?page=1&page_size=10" \
  -H "X-API-Key: YOUR_API_KEY"
Response
{
  "success": true,
  "hotel_id": 702258,
  "data": {
    "imageDomain": "ak-d.tripcdn.com",
    "total_reviews": 919,
    "filterList": [
      {
        "id": 1,
        "name": "All reviews",
        "commentCount": 919,
        "filterType": 1
      },
      {
        "id": 2,
        "name": "Positive reviews",
        "commentCount": 863,
        "filterType": 1
      }
    ],
    "reviews": [
      {
        "id": 1622571051,
        "rating": 9,
        "title": "Great",
        "text": "Generally it was a pleasant stay and experience. It is next to a premium Mall...",
        "date": "2025-11-05 10:30:00",
        "stay_date": "2025-11-01 00:00:00",
        "reviewer_name": "John D.",
        "room_type": "Deluxe Room",
        "travel_type": "Business traveler",
        "images": []
      },
      {
        "id": 1622572098,
        "rating": 8,
        "title": "Very good",
        "text": "Great location, friendly staff, and clean rooms. Would definitely recommend!",
        "date": "2025-09-20 14:22:00",
        "stay_date": "2025-09-15 00:00:00",
        "reviewer_name": "Sarah M.",
        "room_type": "Standard Room",
        "travel_type": "Family",
        "images": ["https://ak-d.tripcdn.com/images/example.jpg"]
      }
    ]
  },
  "retrieved_at": "2025-01-23T12:00:00Z"
}