Trip.com Hotel Search & Nightly Price Finder

Find hotels on Trip.com for a city and stay dates — or pull the complete profile for properties you already know. Every row is a ready-to-use hotel record with its nightly rate, star class, guest score, location, room details and a direct booking link.

Modes

Search hotels by city and dates (searchHotels)

Give a city and optional stay dates and filters. The actor resolves the city through Trip.com's own search service, reads the server-rendered result pages, and returns hotels with the price quoted for your exact dates.

• Pagination that actually advances: Trip.com serves about 12 hotels per result query and ignores page-number parameters. The actor slices the result space across star classes and city zones, de-duplicates by hotel ID, and keeps going until your maxItems is reached or the source is exhausted.
• Date-aware prices: nightly price before tax, nightly price after tax, and the total for the whole stay are all included.
• Filters that change the result set: star range, guest score, nightly budget, breakfast, free cancellation, pay-at-hotel.
• Optional detail enrichment: turn on includeDetails to add the full street address, facilities, description, phone, e-mail and check-in/out times to every search row.

Hotel details by ID or URL (hotelDetail)

Paste one or many Trip.com hotel IDs (or full detail URLs). The actor returns the full property profile — address, facilities, description, policies, photos, contact details, coordinates — and makes a best-effort merge of the current nightly price for your dates when the property appears in the city search.

IDs are taken from hotelIds, and the single hotelId field is combined with it, so both old and new tasks work.

Input

Field	Type	Default	Notes
mode	select	searchHotels	searchHotels or hotelDetail
cityName	text	London	City, or a city + country such as Paris, France
cityId	integer	–	Exact Trip.com geo code; overrides the city name
checkIn / checkOut	text	tomorrow / next night	YYYY-MM-DD
adults	integer	2	1–8 adults per room
rooms	integer	1	1–5 rooms
minStars / maxStars	integer	–	Official star class 1–5
minRating	number	–	Guest score 0–10
maxPrice	number	–	Nightly budget before taxes
breakfastIncluded	boolean	false	Only breakfast-included rates
freeCancellation	boolean	false	Only free-cancellation rates
payAtHotel	boolean	false	Only pay-at-property rates
sortBy	select	recommended	priceLow, priceHigh, rating, stars
currency	select	USD	16 major currencies
includeDetails	boolean	false	Enrich every search row from its detail page
maxItems	integer	20	1–200
hotelId	text	–	One hotel ID or detail URL (detail mode)
hotelIds	string list	–	Multiple hotel IDs or URLs (detail mode)
proxyConfiguration	proxy	direct	Optional; an Apify Proxy fallback is automatic if Trip.com blocks the datacenter IP

Saved tasks that still send older keys — destination, city, query, searchQuery, searchQueries, checkin, checkout, check_in, check_out, adult, roomQuantity, sort, maxResults — keep working because those keys are mapped in code, even when the input form fills the new defaults.

Output

Each dataset row is one hotel.

• hotelId, name, hotelType
• address, neighborhood, positionDesc, city, province, country
• starRating, rating, ratingText, reviewCount, subScores, locationScore
• pricePerNight — nightly rate before taxes
• priceWithTax — nightly rate including taxes and fees
• priceWithTaxTotal — full-stay total including taxes and fees
• currency, priceExplanation, paymentPolicy
• freeCancellation, breakfastIncluded
• roomName, bedType
• amenities[], highlights[], description
• checkInTime, checkOutTime, phone, email
• openYear, renovationYear
• url, thumbnailUrl, imageCount, imageUrls[]
• lat, lon
• checkIn, checkOut, recordType, scrapedAt

Empty values are omitted, never returned as null.

Examples

Search London for a two-night stay:

{
  "mode": "searchHotels",
  "cityName": "London",
  "checkIn": "2026-11-20",
  "checkOut": "2026-11-22",
  "maxItems": 50
}

Four- and five-star hotels under 300 USD with a guest score of at least 8.5:

{
  "mode": "searchHotels",
  "cityName": "Tokyo",
  "checkIn": "2026-11-20",
  "checkOut": "2026-11-22",
  "minStars": 4,
  "minRating": 8.5,
  "maxPrice": 300,
  "sortBy": "priceLow",
  "maxItems": 40
}

Fetch one property, or several at once:

{
  "mode": "hotelDetail",
  "hotelIds": ["731904", "https://www.trip.com/hotels/detail/?hotelId=3037865"],
  "checkIn": "2026-11-20",
  "checkOut": "2026-11-22"
}

Use cases

• Price monitoring: rerun the same city, dates and filters to watch nightly rates move.
• Shortlist building: combine star, score and budget filters to narrow a destination.
• Property research: pull facilities, policies and contact details for a list of known hotels.
• Travel content: compare scores, room types and locations across a city.
• Budget planning: cap the nightly price and see what remains available.

FAQ

Do I need a Trip.com account or cookie? No. City search, hotel search and detail pages are read without logging in.

Why does a search stop before maxItems? Trip.com returns roughly 12 hotels per result query. The actor walks star and zone slices until it reaches your limit or the source runs out of matching properties. Small cities and very narrow filters can exhaust the source sooner; the status message reports the real count.

Are prices per night or for the whole stay? pricePerNight and priceWithTax are nightly. priceWithTaxTotal is the whole-stay total and matches the breakdown text in priceExplanation.

What is the difference between search and detail prices? Search rows always carry the live price for the requested dates. Detail rows try to merge the current price from the same city search. If the property has no availability, or does not appear in the search slices for those dates, the price fields are omitted.

Why are some fields missing on a row? Trip.com does not publish every field for every property — for example, some hotels have no guest reviews, e-mail or neighborhood. Missing fields are omitted rather than filled with placeholders. includeDetails fills the largest set of fields.

Why is the address sometimes just a district in a search row? Search result cards expose only the district. Enable includeDetails, or use hotelDetail, to get the full street address.

Is this affiliated with Trip.com? No. This is an independent third-party tool and is not operated by or affiliated with Trip.com or Ctrip.