GET
Ctrip Hotel Search API
Find Ctrip properties by city ID, then use each hotel_id for details, rooms, or reviews.
Endpoint
GET https://api.stayapi.com/v1/ctrip/hotels/search
Authenticate with your StayAPI key in the X-API-Key header.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | integer | Required | Ctrip city ID. Hangzhou is 17. Minimum 1. |
| check_in | date | Optional | YYYY-MM-DD. Supply with check_out; defaults to 14 days from today. |
| check_out | date | Optional | YYYY-MM-DD. Supply with check_in; maximum stay is 30 nights. |
| page | integer | Optional | Only page 1 is currently supported. Default 1. |
| limit | integer | Optional | Hotels to return, from 1 to 13. Default 10. |
Request example
curl "https://api.stayapi.com/v1/ctrip/hotels/search?city_id=17&check_in=2026-08-15&check_out=2026-08-16&limit=10" \
-H "X-API-Key: YOUR_API_KEY"Success response
{
"success": true,
"city_id": 17,
"check_in": "2026-08-15",
"check_out": "2026-08-16",
"hotels": [{
"hotel_id": 18078321,
"name": "杭州临平万丽酒店",
"name_en": "Renaissance Hangzhou Northeast Hotel",
"guest_rating": 4.7,
"review_count": 792,
"available": true,
"url": "https://hotels.ctrip.com/hotels/18078321.html"
}],
"returned": 1,
"total": 10379,
"page": 1,
"prices_included": false
}
Limits and errors
- The public Ctrip SSR feed currently exposes only the first page and at most 13 hotels.
- Search returns availability and a sample room, but not bookable rate-plan prices.
- Errors are non-2xx RFC 7807 Problem Details responses with
provider: "ctrip"and a correlation id.