GET
Ctrip Hotel Details API
Return the stable property profile behind a Ctrip hotel ID, including multilingual names, location, ratings, facilities, policies, and photos.
Endpoint
GET https://api.stayapi.com/v1/ctrip/hotel/details/{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 from search, URL extraction, or a Ctrip hotel URL. |
Request example
curl "https://api.stayapi.com/v1/ctrip/hotel/details/18078321" \
-H "X-API-Key: YOUR_API_KEY"Success response
{
"success": true,
"hotel_id": 18078321,
"name": "杭州临平万丽酒店",
"name_en": "Renaissance Hangzhou Northeast Hotel",
"star_rating": 5.0,
"address": "人民大道607号",
"city_id": 17,
"rating": 4.7,
"rating_max": 5.0,
"review_count": 792,
"amenities": [{
"code": 102,
"name": "公用区wifi",
"category": "公共区",
"fee_label": "免费"
}],
"photos": [{
"url": "https://example.com/hotel.jpg",
"picture_id": 1
}],
"url": "https://hotels.ctrip.com/hotels/18078321.html"
}
Limits and errors
- Details are fetched live from Ctrip through the configured residential proxy.
- Nullable fields remain null when Ctrip does not publish them; arrays remain present and may be empty.
- Errors are non-2xx RFC 7807 Problem Details responses with
provider: "ctrip"and a correlation id.