Trip.com Hotel Detail API Documentation Get one hotel by id or by Trip.com hotel URL: description, contact, address, coordinates, nearby places, guest score with its breakdown, check-in and check-out times, amenity groups with free or fee flags, policies, photos at 960 px, room types with size, beds and photos, and the questions and answers of the page. Room types have no prices. Use hotel search for the cheapest offer per hotel. Cost: 1 credit.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
string
Required
Trip.com hotel id from the suggest or search endpoint. Example: 718146. Send hotel_id or url.
1234567890
string
Optional
A trip.com hotel URL with a hotel id. Used when hotel_id is empty.
https://example.com/product
string
Optional
Site language: en, en-gb, de, fr, ja, ko or zh-hk. Defaults to en.
en-US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"faq": [
{
"answer": "Nearby attractions to Hotel R\u00e9gence Etoile include Arc de Triomphe de l\u2019Etoile, just 1100 ft from your search (straight-line distance) away.",
"question": "What landmarks are near Hotel R\u00e9gence Etoile?"
}
],
"url": "https://www.trip.com/hotels/detail/?hotelId=718146",
"city": "Paris",
"name": "Hotel R\u00e9gence Etoile",
"email": "contact@hotelregenceetoile.com",
"phone": "+33-1-58054242",
"rooms": [
{
"bed": "1 Queen bed",
"name": "Classic Room",
"floor": "Floor: 1-6",
"photos": [
"https://aw-d.tripcdn.com/images/1mc0n12000dtpcf0bBB51.jpg"
],
"window": "Has window",
"room_id": "39799920",
"size_m2": 14,
"smoking": "Non-smoking",
"features": [
"Air conditioning",
"Private bathroom",
"Refrigerator",
"Daily housekeeping",
"Bath towels"
],
"max_guests": 2,
"max_children": 1
}
],
"stars": 4,
"photos": [
"https://aw-d.tripcdn.com/images/0582t12000jbiuxe0A6C0_R_960_660_R5_D.jpg",
"https://aw-d.tripcdn.com/images/1mc0z12000dtpczk60AF2_R_339_206_R5_D.jpg"
],
"rating": {
"label": "Great",
"scale": 10,
"score": 9.2,
"breakdown": [
{
"name": "Cleanliness",
"score": 9.4
},
{
"name": "Amenities",
"score": 8.9
},
{
"name": "Location",
"score": 9.4
},
{
"name": "Service",
"score": 9.2
}
],
"recommended": "90% Recommended",
"review_count": 562
},
"region": "Ile-de-France",
"city_id": "192",
"country": "France",
"check_in": "After 15:00",
"hotel_id": "718146",
"location": {
"zone": "Champs Elys\u00e9es",
"nearby": [
{
"name": "Arc de Triomphe de l\u2019Etoile",
"type": "Attraction",
"distance": "1300 ft"
},
{
"name": "Charles de Gaulle - \u00e9toile",
"type": "Subway station",
"distance": "550 ft"
}
],
"address": "24 Av. Carnot, Paris, 75017, France",
"latitude": 48.876537,
"longitude": 2.292983,
"transport": "550 ft from Charles de Gaulle-Etoile, approx. 3 mins on foot"
},
"policies": [
{
"text": "Check-in: After 15:00 Check-out: Before 12:00 Front desk hours: 24/7 If you plan to arrive after 00:00 on your check-in day, contact the property in advance by email/phone.At the same time, please provide your check-in time",
"topic": "Check-in and Check-out Times"
},
{
"text": "Children of all ages are welcome at this property. Additional fees may be charged for children using existing beds. Add the number of children to get a more accurate price.",
"topic": "Child policies"
}
],
"amenities": [
{
"group": "Internet",
"items": [
{
"cost": "free",
"name": "Wi-Fi in public areas",
"note": "Free"
}
]
}
],
"check_out": "Before 12:00",
"local_name": "Hotel R\u00e9gence Etoile",
"description": "A stay at H\u00f4tel R\u00e9gence Etoile places you in the heart of Paris, a 1-minute drive from Arc de Triomphe and 6 minutes from Eiffel Tower. This upscale hotel is 2.3 mi (3.6 km) from Palais Garnier and 2.3 mi (3.6 km) from La Machine du Moulin Rouge.",
"opened_year": 1930,
"photo_count": 3,
"renovated_year": 2017
},
"meta": {
"billable": true,
"endpoint_family": "hotel_detail"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"hotel_id": [
"A hotel id or a Trip.com hotel URL is required. Take the id from the suggest or search endpoint."
]
},
"message": "The request validation failed"
}Resource Not Found
The id is unknown. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "trip_com"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested Trip.com resource was not found."
},
"success": false
}Unexpected Upstream Answer
Trip.com answered with a page or payload Scrappa cannot read. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "trip_com"
},
"error": {
"code": "PARSER_DRIFT",
"message": "The Trip.com API is temporarily unavailable. Please retry."
},
"success": false
}Upstream Unavailable
Trip.com did not answer after one retry. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "trip_com"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Trip.com API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.