# HomeToGo Price Histogram API Documentation

<p><strong>HomeToGo Price Histogram API Documentation</strong> Get the distribution of nightly prices of a destination for a stay. Each bucket has an upper price in the chosen currency and a relative frequency from 0 to 100, where 100 is the most common price range.</p>

- **Documentation:** [https://scrappa.co/docs/hometogo-api/hometogo_price_histogram](https://scrappa.co/docs/hometogo-api/hometogo_price_histogram)
- **API group:** HomeToGo API
- **Endpoint:** `GET https://scrappa.co/api/hometogo/price-histogram`

## 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 |
| --- | --- | --- | --- |
| `location_id` | string | No | HomeToGo destination id from the suggest endpoint. Example: 5460aead9281b for Paris. Send this or destination. |
| `destination` | string | No | Destination name as in the HomeToGo address, e.g. paris, munich or new-york. Send this or location_id. |
| `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-18. |
| `adults` | integer | No | Number of adults, 1 to 16. Defaults to 2. |
| `children` | integer | No | Number of children, 0 to 10. Children count as guests. Defaults to 0. |
| `currency` | string | No | Price currency: EUR, USD, GBP, CHF, SEK, DKK, NOK, PLN, CZK, CAD or AUD. Defaults to EUR. |

## Example response

```json
{
    "data": {
        "buckets": [
            {
                "price": 9,
                "relative_frequency": 0
            },
            {
                "price": 31,
                "relative_frequency": 2
            },
            {
                "price": 53,
                "relative_frequency": 8
            },
            {
                "price": 75,
                "relative_frequency": 17
            },
            {
                "price": 97,
                "relative_frequency": 32
            },
            {
                "price": 119,
                "relative_frequency": 57
            }
        ],
        "check_in": "2026-12-01",
        "currency": "EUR",
        "check_out": "2026-12-08",
        "location_id": "5460aead9281b"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "rental_price_histogram"
    },
    "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 destination is unknown. This response is not billable. |
| 503 | Service Unavailable | HomeToGo could not be reached or blocked the request. Retry later. This response is not billable. |
| 502 | Unexpected Answer | HomeToGo answered with a shape this API does not know. 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)