Browse documentation
GET

Ctrip Hotel Reviews API

Return Ctrip's first-page guest review feed in StayAPI's normalized cross-provider review shape.

Endpoint

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

Authenticate with your StayAPI key in the X-API-Key header.

Parameters

Parameter Type Required Description
hotel_id integer (path) Required Positive Ctrip hotel ID.
page integer Optional Only page 1 is currently available. Default 1.
page_size integer Optional Reviews to return, 1 to 10. Default 10.
currency string Optional Currency context. Default CNY.
locale string Optional Locale context. Default zh-CN.

Request example

curl "https://api.stayapi.com/v1/ctrip/hotel/reviews/18078321?page=1&page_size=10" \
  -H "X-API-Key: YOUR_API_KEY"

Success response

{
  "success": true,
  "hotel_id": 18078321,
  "data": {
    "total_reviews": 792,
    "reviews": [{
      "id": 2018492261,
      "rating": 5,
      "title": "超棒",
      "text": "带娃打卡,服务很好,房间很干净。",
      "date": "2026-07-12 10:00:00",
      "stay_date": "2026-07-10 00:00:00",
      "reviewer_name": "Ctrip guest",
      "room_type": "豪华大床房",
      "travel_type": "家庭亲子",
      "images": ["https://example.com/review.jpg"],
      "owner_response": null
    }]
  },
  "retrieved_at": "2026-07-29T12:00:00Z"
}

Limits and errors

  • Ctrip currently exposes only the first review page, with up to 10 reviews.
  • Reviews are fetched in the shared isolated Trip.com Group browser pool; 503 indicates temporary pool saturation.
  • A hotel with no reviews returns 404. Upstream anti-bot blocking returns 502 rather than a false empty result.
  • Errors are non-2xx RFC 7807 Problem Details responses with provider: "ctrip" and a correlation id.

Related Ctrip endpoints