# Trip.com Hotel Detail API Documentation

<p><strong>Trip.com Hotel Detail API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/tripcom-api/tripcom_hotels_detail](https://scrappa.co/docs/tripcom-api/tripcom_hotels_detail)
- **API group:** Trip.com API
- **Endpoint:** `GET https://scrappa.co/api/tripcom/hotels/detail`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `hotel_id` | string | Yes | Trip.com hotel id from the suggest or search endpoint. Example: 718146. Send hotel_id or url. |
| `url` | string | No | A trip.com hotel URL with a hotel id. Used when hotel_id is empty. |
| `locale` | string | No | Site language: en, en-gb, de, fr, ja, ko or zh-hk. Defaults to en. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The id is unknown. This response is not billable. |
| 502 | Unexpected Upstream Answer | Trip.com answered with a page or payload Scrappa cannot read. This response is not billable. Retry later. |
| 503 | Upstream Unavailable | Trip.com did not answer after one retry. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)