Trip.com Travel Hotel Search API
Send a Trip.com city hotel page, such as London hotels, and get every hotel on it with its rating, review count, position and link.
- 1 credit per call
- Failed calls are free
- Updated
- tripcom.hotel.search
{ "has_more": false, "query": "London", "total_found": 31, "listings": [ { "title": "Holiday Inn Express LONDON - LIMEHOUSE by IHG", "rating": 8.6, "reviews": 730, "id": "2196184", "page": 1, "position": 1, "url": "https://nz.trip.com/hotels/london-hotel-detail-2196184/holiday-inn-express-london-limehouse-by-ihg/" }, { "title": "Strand Palace", "rating": 9.2, "reviews": 560, "id": "731904", "page": 1, "position": 2, "url": "https://nz.trip.com/hotels/london-hotel-detail-731904/strand-palace-hotel-london/" } ]}
| # | Hotel | Rating | Reviews | Position | Hotel ID | Link | Page |
|---|---|---|---|---|---|---|---|
| 1 | Holiday Inn Express LONDON - LIMEHOUSE by IHG | 8.6 | 730 | 1 | 2196184 | https://nz.trip.com/hotels/london-hotel-detail-2196184/holiday-… | 1 |
| 2 | Strand Palace | 9.2 | 560 | 2 | 731904 | https://nz.trip.com/hotels/london-hotel-detail-731904/strand-pa… | 1 |
| 3 | Riu Plaza London The Westminster | 9 | 338 | 3 | 1572524 | https://nz.trip.com/hotels/london-hotel-detail-1572524/riu-plaz… | 1 |
| 4 | Royal National Hotel | 8.2 | 3190 | 4 | 2985758 | https://nz.trip.com/hotels/london-hotel-detail-2985758/royal-na… | 1 |
| 5 | Holiday Inn LONDON - KENSINGTON HIGH ST. by IHG | 8.3 | 514 | 5 | 730803 | https://nz.trip.com/hotels/london-hotel-detail-730803/holiday-i… | 1 |
| 6 | Travelodge London Central City Road | 8.1 | 59 | 6 | 18143221 | https://nz.trip.com/hotels/london-hotel-detail-18143221/travelo… | 1 |
| 7 | The Imperial | 9 | 63 | 7 | 3061459 | https://nz.trip.com/hotels/london-hotel-detail-3061459/the-impe… | 1 |
| 8 | Travelodge London Wembley | 8.7 | 55 | 8 | 17500546 | https://nz.trip.com/hotels/london-hotel-detail-17500546/travelo… | 1 |
| 9 | Riu Plaza London Victoria | 9.1 | 172 | 9 | 101185681 | https://nz.trip.com/hotels/london-hotel-detail-101185681/hotel-… | 1 |
| 10 | Britannia International Hotel Canary Wharf | 10 | 730568 | https://nz.trip.com/hotels/london-hotel-detail-730568/britannia… | 1 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| listing_url | string | yes | A Trip.com city hotel page, such as https://nz.trip.com/hotels/london-hotels-list-338/. | https://nz.trip.com/hotels/london-hotels-list-3… |
| adults | integer | no | Optional number of adults. | |
| amenities | array<string> | no | Leave out: the list is not filtered by amenities. | |
| check_in | string | no | Leave out: hotel search returns the hotels on the page without date-based prices. | |
| check_out | string | no | Leave out, like check_in. | |
| children | integer | no | Optional number of children. | |
| currency | string | no | Currency code, such as GBP. | |
| locale | string | no | Language, such as en. | |
| max_pages | integer | no | Leave at 1. | |
| page | integer | no | Page 1 of the hotel page; that is the page available today. | |
| rooms | integer | no | Optional number of rooms. |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| listings[].title | string | The hotel's name. | Holiday Inn Express LONDON - LIMEHOUSE by IHG |
| listings[].rating | number | The hotel's guest rating out of 10. | 8.6 |
| listings[].reviews | integer | How many reviews the hotel has. | 730 |
| listings[].position | integer | The hotel's position in the results. | 1 |
| listings[].id | string | Trip.com's ID for the hotel; pass it to the hotel endpoint. | 2196184 |
| listings[].url | string | The hotel's page on Trip.com. | https://nz.trip.com/hotels/london-hotel-detail-2196184/holiday-… |
| listings[].page | integer | The results page the hotel was on. | 1 |
| has_more | boolean | Whether more hotels follow. | false |
| listings | array | The hotels found. | 31 records |
| query | string | The place you searched. | London |
| total_found | integer | How many hotels were found. | 31 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "tripcom.hotel.search", "input": { "listing_url": "https://nz.trip.com/hotels/london-hotels-list-338/" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "tripcom.hotel.search", "input": { "listing_url": "https://nz.trip.com/hotels/london-hotels-list-338/" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "tripcom.hotel.search", "input": { "listing_url": "https://nz.trip.com/hotels/london-hotels-list-338/" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
Use Upscrape to get the hotels on Trip.com's London hotel page (https://nz.trip.com/hotels/london-hotels-list-338/) and give me a table of hotel, rating and review count, best rated first.
More from the Trip.com Travel API
- Trip.com Travel Hotel Detail API1 credit
- Trip.com Travel Attractions Search API1 credit
- Trip.com Travel Attraction Detail API1 credit
- Trip.com Travel Flight Search API1 credit
- Trip.com Travel Public Hotel Reviews API1 credit
- Trip.com Travel Train Search API1 credit
- Trip.com Travel Car Rental Search API1 credit
Trip.com Travel Hotel Search API FAQ
The short answers. The docs have the long ones.
How much does the Trip.com Travel Hotel Search API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send listing_url. The input fields below list every option with its type and limits.
Do I need a Trip.com Travel login?
No. It reads public Trip.com Travel data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds tripcom.hotel.search, checks its price and runs it with the same credits as the REST API.
Your first Trip.com Travel call is free.
Up to 100 free credits to start, no card needed.