Ctrip API

The Ctrip API for hotel search, rooms, prices, and reviews.

Q: Is the Ctrip API free?

You get 50 free requests on signup, no credit card. After that, every Ctrip endpoint uses the same StayAPI request-credit model as the other providers.

Pull hotel search, property details, room availability, advertised low prices, and guest reviews from Ctrip as clean JSON.

REQUEST GET

USE CASE Find Ctrip hotels in Hangzhou by city ID.

curl "https://api.stayapi.com/v1/ctrip/hotels/search" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "city_id=17" \
  -d "check_in=2026-08-15" \
  -d "check_out=2026-08-16" \
  -d "limit=10"

USE CASE Get normalized content for one Ctrip hotel ID.

curl "https://api.stayapi.com/v1/ctrip/hotel/details/18078321" \
  -G \
  -H "x-api-key: $STAYAPI_KEY"

USE CASE Check availability and the public advertised low price for a stay.

curl "https://api.stayapi.com/v1/ctrip/hotel/rooms/18078321" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "check_in=2026-08-15" \
  -d "check_out=2026-08-16" \
  -d "adults=2" \
  -d "rooms=1"

USE CASE Get normalized guest feedback for a Ctrip hotel.

curl "https://api.stayapi.com/v1/ctrip/hotel/reviews/18078321" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "page=1" \
  -d "page_size=10"

RESPONSE 200 OK

2.41s

{
  "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,
      "address": "人民大道607号",
      "available": true,
      "url": "https://hotels.ctrip.com/hotels/18078321.html"
    }
  ],
  "returned": 1,
  "total": 10379,
  "page": 1,
  "prices_included": false
}

{
  "success": true,
  "hotel_id": 18078321,
  "name": "杭州临平万丽酒店",
  "name_en": "Renaissance Hangzhou Northeast Hotel",
  "star_rating": 5,
  "address": "人民大道607号",
  "city_id": 17,
  "rating": 4.7,
  "rating_max": 5,
  "review_count": 792,
  "room_count": 172,
  "check_in": "入住时间： 15:00后",
  "check_out": "退房时间： 12:00前",
  "main_photo": "https://example.com/hotel.jpg",
  "url": "https://hotels.ctrip.com/hotels/18078321.html"
}

{
  "success": true,
  "hotel_id": 18078321,
  "check_in": "2026-08-15",
  "check_out": "2026-08-16",
  "nights": 1,
  "adults": 2,
  "children_ages": [],
  "rooms_requested": 1,
  "currency": "CNY",
  "available": true,
  "lowest_price": {
    "amount": 686,
    "currency": "CNY",
    "symbol": "¥",
    "basis": "advertised_from_price"
  },
  "room_prices_included": false,
  "room_price_limitation": "Individual rate-plan prices require a Ctrip login.",
  "room_types": [],
  "total_room_types": 0,
  "total_rate_plans": 0
}

{
  "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": [],
        "owner_response": null
      }
    ]
  },
  "retrieved_at": "2026-07-29T12:00:00Z"
}

Start free with 50 requests Read the docs

99.9% uptime ~3s avg response Live, not cached

Trusted by hospitality teams at

Overview

What the Ctrip API gives you.

Ctrip is one of China's main hotel booking platforms, but its public hotel pages and booking flow are built for browsers, not direct data access. Search, property content, room availability, pricing, and guest feedback arrive through several different page and API contracts.

StayAPI turns those contracts into one REST surface. Start with a Ctrip city ID or hotel URL, get a stable hotel_id, then call details, rooms, or reviews with the same identifier. Responses are normalized JSON and errors use RFC 7807 Problem Details.

One hotel ID across the workflow.

Search by city_id or resolve a public Ctrip URL, then use the returned hotel_id for property details, room availability, lowest price, and reviews.

Public pricing, stated honestly.

The rooms endpoint returns Ctrip's anonymous advertised from-price. Individual rate-plan prices are marked login_required instead of being guessed or silently omitted.

Live source data.

Search, property content, availability, and reviews are fetched from Ctrip at request time through bounded proxy and browser infrastructure.

View pricing View the docs

Endpoints

Every Ctrip endpoint, one base URL.

Each returns normalized JSON in the same shape. Click any endpoint for parameters, an example response, and a live playground.

GET Hotel search /v1/ctrip/hotels/search Search Ctrip's public first-page hotel feed by stable city ID, with ratings, location, availability, and a sample room. GET URL to hotel ID /v1/ctrip/hotel/extract-id Extract and normalize the numeric hotel ID from supported desktop and mobile Ctrip hotel URLs. GET Hotel details /v1/ctrip/hotel/details/{hotel_id} Property names, description, coordinates, ratings, amenities, policies, highlights, and photos. GET Rooms and lowest price /v1/ctrip/hotel/rooms/{hotel_id} Stay-specific room availability and Ctrip's anonymous advertised from-price, with login-gated rate prices identified explicitly. GET Hotel reviews /v1/ctrip/hotel/reviews/{hotel_id} First-page guest reviews with rating, text, stay date, room type, travel type, images, and property responses.

Browse the full Ctrip docs

Use cases

What teams build on the Ctrip API.

The same endpoints, pointed at different jobs. These are the ones we see most.

Ctrip property discovery.

Search a market by Ctrip city ID and store the stable hotel IDs, names, coordinates, ratings, review counts, and canonical URLs.

China market content sync.

Keep multilingual names, descriptions, amenities, policies, highlights, and photo URLs current for properties represented on Ctrip.

Availability and price monitoring.

Check whether a property is available for a stay and track the advertised anonymous from-price without presenting login-only rate plans as public prices.

Guest review monitoring.

Pull the newest public first-page review feed into a reputation workflow, including guest stay date, room type, images, and any property response.

Cross-OTA hotel matching.

Use coordinates, English and Chinese names, address, and stable Ctrip IDs to match Ctrip inventory with the same properties on other channels.

Pricing

50 free requests on signup.
Pick a plan when you need more.

Flat monthly plans, every endpoint included on every plan. 1 request = 1 credit. No per-endpoint multipliers, no surprise overages.

01 Free

Wire it up. See the schema.

$0 to start

50 free requests on signup
Every endpoint included
No credit card required
Same schema as paid

Start free

02 Basic

Kick the tires in production.

$49 per month

1,500 requests / month
Every endpoint included
Per-endpoint usage dashboard
Email support

Start Basic

What people ask about the Ctrip API.

Don't see your question? Email us at info@stayapi.com.

Does Ctrip have a public hotel data API?

Ctrip provides partner and affiliate products, but it does not offer an open self-serve API for its public hotel search, property content, anonymous room availability, and guest reviews. StayAPI exposes those surfaces through authenticated REST endpoints.

How do I find a Ctrip hotel ID?

Use /v1/ctrip/hotels/search with a Ctrip city_id, or pass a public desktop or mobile hotel URL to the URL-to-ID endpoint. Both return the numeric hotel_id used by details, rooms, and reviews.

Can the Ctrip API return room prices?

The rooms endpoint returns the hotel-level advertised public from-price and room availability. Ctrip gates individual rate-plan prices behind login, so those values are returned as null with price_visibility: login_required.

Can I paginate all Ctrip search results and reviews?

Not on the current public contract. Search exposes the first page with up to 13 hotels, and reviews exposes the first page with up to 10 reviews. The endpoint bounds enforce those limits instead of implying unsupported pagination.

Is the Ctrip API free?

You get 50 free requests on signup, no credit card. After that, every Ctrip endpoint uses the same StayAPI request-credit model as the other providers.

Two ways to start.

Both end with live Ctrip data in your stack. The fast path is on the left.

01 · the fast path

Try it free

50 free requests after sign up. Fastest way to see if the schema fits.