# Trivago Hotel Offers API Documentation

<p><strong>Trivago Hotel Offers API Documentation</strong> Get the offers of every booking site for one hotel and stay. Each offer has the provider name and logo, room type, price per night and per stay, the same prices with taxes and fees, currency, free cancellation (with the deadline when known), pay later, meal plan and a deal link. Offers are sorted by price per night. Trivago lists offers only for stays it holds a current price for, and often only for stays of one night. If there is none, the response is a successful empty list with a note, and it is not billed. The deal link opens the booking site through Trivago.</p>

- **Documentation:** [https://scrappa.co/docs/trivago-api/trivago_deals](https://scrappa.co/docs/trivago-api/trivago_deals)
- **API group:** Trivago API
- **Endpoint:** `GET https://scrappa.co/api/trivago/deals`

## 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` | integer | Yes | Trivago hotel id from the suggest or search endpoint. Example: 5670. |
| `check_in` | string | Yes | Check-in date, YYYY-MM-DD, today or later. Example: 2027-03-14. |
| `check_out` | string | Yes | Check-out date, YYYY-MM-DD, after check-in, at most 30 nights. Example: 2027-03-15. |
| `adults` | integer | No | Number of adults, 1 to 30. Defaults to 2. |
| `rooms` | integer | No | Number of rooms, 1 to 9, not more than adults. Defaults to 1. |
| `children_ages` | string | No | Comma-separated ages of the children, each 0 to 17, up to 6. Example: 5,7. |
| `currency` | string | No | Three-letter uppercase currency code. Defaults to the currency of the market. |
| `market` | string | No | Trivago country site: us, de, uk, fr, es, it or nl. Sets language, currency and prices. Defaults to us. |

## Example response

```json
{
    "data": {
        "market": "us",
        "nights": 1,
        "offers": [
            {
                "id": "1543566299014695026",
                "currency": "USD",
                "deal_url": "https://www.trivago.com/forward/en-US?forwarderA=EXAMPLE",
                "provider": {
                    "id": 395,
                    "logo": "https://imgcy.trivago.com/partnerlogos-s3/395",
                    "name": "Agoda"
                },
                "meal_plan": "room_only",
                "pay_later": false,
                "room_type": "Double Room",
                "room_category": "standard",
                "price_per_stay": 111,
                "price_per_night": 111,
                "free_cancellation": false,
                "breakfast_included": false,
                "price_per_stay_with_fees": 134,
                "price_per_night_with_fees": 134
            },
            {
                "id": "-2711303296388992688",
                "currency": "USD",
                "deal_url": "https://www.trivago.com/forward/en-US?forwarderA=EXAMPLE",
                "provider": {
                    "id": 626,
                    "logo": "https://imgcy.trivago.com/partnerlogos-s3/626",
                    "name": "Booking.com"
                },
                "meal_plan": "room_only",
                "pay_later": false,
                "price_per_stay": 120,
                "price_per_night": 120,
                "free_cancellation": false,
                "breakfast_included": false,
                "price_per_stay_with_fees": 143,
                "price_per_night_with_fees": 143
            }
        ],
        "check_in": "2027-03-14",
        "currency": "USD",
        "hotel_id": 5670,
        "check_out": "2027-03-15",
        "offer_count": 20,
        "provider_count": 13,
        "lowest_price_per_night": 111
    },
    "meta": {
        "billable": true,
        "endpoint_family": "hotel_offers"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The hotel id is unknown. This response is not billable. |
| 503 | Service Unavailable | Trivago could not be reached or answered with an unexpected shape. This response is not billable. |

## 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)