# Trivago Hotel Price Calendar API Documentation

<p><strong>Trivago Hotel Price Calendar API Documentation</strong> Get a day by day price calendar for one hotel. Each day has the low price forecast per night in the currency you ask for. The response also names the cheapest day and counts the days that have a price. The calendar covers up to 91 days in one request. The price is a forecast of low prices on Trivago (not a bookable offer). Use the offers endpoint to read live prices for a stay. A day without a forecast has a null price. Trivago has no forecast for most hotels more than a few months ahead. If no day has a price, the response is a successful answer with a note, and it is not billed.</p>

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

## 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. |
| `start_date` | string | Yes | First day of the calendar, formatted YYYY-MM-DD. Today or later. Example: 2026-12-01. |
| `end_date` | string | Yes | Last day of the calendar, formatted YYYY-MM-DD. On or after the start date, at most 91 days in total. Example: 2026-12-07. |
| `currency` | string | No | Three-letter uppercase currency code, e.g. USD or EUR. 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": {
        "days": [
            {
                "date": "2026-12-01",
                "price_per_night": 96
            },
            {
                "date": "2026-12-02",
                "price_per_night": 107
            },
            {
                "date": "2026-12-03",
                "price_per_night": 101
            },
            {
                "date": "2026-12-04",
                "price_per_night": 78
            },
            {
                "date": "2026-12-05",
                "price_per_night": 74
            },
            {
                "date": "2026-12-06",
                "price_per_night": 68
            },
            {
                "date": "2026-12-07",
                "price_per_night": 109
            }
        ],
        "market": "us",
        "currency": "USD",
        "end_date": "2026-12-07",
        "hotel_id": 5670,
        "day_count": 7,
        "price_type": "forecast_low",
        "start_date": "2026-12-01",
        "cheapest_day": {
            "date": "2026-12-06",
            "price_per_night": 68
        },
        "priced_day_count": 7
    },
    "meta": {
        "billable": true,
        "endpoint_family": "hotel_price_calendar"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid, or the window is longer than 91 days. 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)
