# Google Hotels Price Calendar

<p>Get the nightly price of one property for every check-in date of a window in one request. A whole year costs 1 credit, not one paid call per date.</p><h3>What You Get</h3><ul><li><strong>One row per check-in date</strong>, sorted by date, with the check-out date and the number of nights</li><li><strong>Price</strong> as a number, the display price and the currency</li><li><strong>Availability</strong>: a day without a price has <code>available: false</code> and <code>price: null</code>, never 0</li><li><strong>Window up to 365 days</strong>, stays of 1 to 7 nights and 1, 2 or 4 adults</li></ul><h3>Good to Know</h3><ul><li>The price is the lowest price Google shows for that stay. About half of the days beyond six months have no price yet.</li><li>Prices are live and can change between two calls. Children and infants are not supported.</li><li>Google does not price every stay. For example, 4 adults for 3 or more nights can come back with every day unavailable on small properties.</li><li>Cost: 1 credit per successful request. Failed requests are not billed.</li></ul>

- **Documentation:** [https://scrappa.co/docs/google-hotels-api/google_hotels_price_calendar](https://scrappa.co/docs/google-hotels-api/google_hotels_price_calendar)
- **API group:** Google Hotels API
- **Endpoint:** `GET https://scrappa.co/api/google-hotels/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 |
| --- | --- | --- | --- |
| `property_token` | string | Yes | <p>The property token of the hotel or vacation rental.</p><p><strong>Example:</strong> <code>ChkI3t3pndiZ0_knGg0vZy8xMWY3N19iX214EAE</code></p><p><strong>Note:</strong> From the <code>property_token</code> field of a <a href="/docs/google-hotels-api/google_hotels_search">Google Hotels Search</a> result or a <a href="/docs/google-hotels-api/google_hotels_autocomplete">Google Hotels Autocomplete</a> suggestion.</p> |
| `check_in_start` | string | Yes | <p>First check-in date of the window, <code>YYYY-MM-DD</code>. Today or later.</p> |
| `check_in_end` | string | Yes | <p>Last check-in date of the window, <code>YYYY-MM-DD</code>. At most 365 days after the start.</p> |
| `nights` | string | No | <p>Length of the stay (1-7). <strong>Default:</strong> <code>1</code></p> |
| `adults` | string | No | <p>Number of adults: <code>1</code>, <code>2</code> or <code>4</code>. <strong>Default:</strong> <code>2</code></p> |
| `currency` | string | No | <p>3-letter currency code. <strong>Default:</strong> <code>USD</code></p> |
| `hl` | string | No | <p>2-letter language code. <strong>Default:</strong> <code>en</code></p> |
| `gl` | string | No | <p>2-letter country code. <strong>Default:</strong> <code>us</code></p> |

## Example response

```json
{
    "calendar": [
        {
            "price": 81.68,
            "nights": 1,
            "currency": "USD",
            "available": true,
            "check_in_date": "2026-11-13",
            "display_price": "$82",
            "check_out_date": "2026-11-14",
            "price_with_fees": null
        },
        {
            "price": 118.39,
            "nights": 1,
            "currency": "USD",
            "available": true,
            "check_in_date": "2026-11-14",
            "display_price": "$118",
            "check_out_date": "2026-11-15",
            "price_with_fees": null
        },
        {
            "price": null,
            "nights": 1,
            "currency": "USD",
            "available": false,
            "check_in_date": "2026-11-15",
            "display_price": null,
            "check_out_date": "2026-11-16",
            "price_with_fees": null
        }
    ],
    "search_parameters": {
        "gl": "us",
        "hl": "en",
        "adults": 2,
        "engine": "google_hotels_price_calendar",
        "nights": 1,
        "currency": "USD",
        "check_in_end": "2026-11-15",
        "check_in_start": "2026-11-13",
        "property_token": "ChkI3t3pndiZ0_knGg0vZy8xMWY3N19iX214EAE"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The property_token, check_in_start, check_in_end, nights, adults, currency, hl or gl query parameter failed validation before the upstream request ran. |
| 503 | Google Hotels Price Calendar Temporarily Unavailable | The upstream lookup failed on every try. The request is not billed. |

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