# HolidayCheck Hotels API Documentation

<p><strong>HolidayCheck Hotels API Documentation</strong> List the hotels of one HolidayCheck destination, sorted by the HolidayCheck ranking (best first). Each hotel has the id, name, public page url, stars, coordinates, parent places, rating on the 1 to 6 HolidayCheck scale, recommendation_rate as a share between 0 and 1 (0.994 means 99.4 percent) and the number of reviews. Hotels without reviews have no rating fields. Page with limit and offset, total is the number of hotels of the destination. An unknown destination id returns an empty list.</p>

- **Documentation:** [https://scrappa.co/docs/holidaycheck-api/holidaycheck_hotels](https://scrappa.co/docs/holidaycheck-api/holidaycheck_hotels)
- **API group:** HolidayCheck API
- **Endpoint:** `GET https://scrappa.co/api/holidaycheck/hotels`

## 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 |
| --- | --- | --- | --- |
| `destination_id` | string | Yes | HolidayCheck destination UUID from the autocomplete endpoint. Example: 07f5f656-4acc-3230-b7dd-aec3c13af37c (Mallorca). |
| `limit` | integer | No | Hotels per page, 1 to 50. Defaults to 20. |
| `offset` | integer | No | Number of hotels to skip, 0 to 10000. Defaults to 0. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": "ca4f8420-dadc-4a92-a10f-ec8a8d9d6a96",
                "url": "https://www.holidaycheck.de/hi/x/ca4f8420-dadc-4a92-a10f-ec8a8d9d6a96",
                "name": "Agroturismo Can Pere Rei",
                "stars": 4,
                "rating": 6,
                "parents": [
                    "Son Serra de Marina",
                    "Mallorca",
                    "Spanien",
                    "Europa"
                ],
                "location": {
                    "latitude": 39.71382,
                    "longitude": 3.21608
                },
                "review_count": 866,
                "recommendation_rate": 1
            },
            {
                "id": "0422e5fc-dfd1-3957-bcdc-123e41e523f2",
                "url": "https://www.holidaycheck.de/hi/x/0422e5fc-dfd1-3957-bcdc-123e41e523f2",
                "name": "Grupotel Parc Natural & Spa",
                "stars": 5,
                "rating": 5.91,
                "parents": [
                    "Platja de Muro / Playa de Muro",
                    "Mallorca",
                    "Spanien",
                    "Europa"
                ],
                "location": {
                    "latitude": 39.7994195,
                    "longitude": 3.1198597
                },
                "review_count": 1619,
                "recommendation_rate": 0.994
            }
        ],
        "limit": 2,
        "total": 15353,
        "offset": 0,
        "has_more": true
    },
    "meta": {
        "billable": true,
        "endpoint_family": "hotels"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | HolidayCheck could not be reached or answered in an unexpected format. 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)