# HolidayCheck Hotel Reviews API Documentation

<p><strong>HolidayCheck Hotel Reviews API Documentation</strong> Page through the public guest reviews of one HolidayCheck hotel, newest travel date first. Each review has the title, review text, per-category texts, recommended flag, ratings per category and aspect on the 1 to 6 HolidayCheck scale, travel date and entry date (ISO 8601, UTC), travel duration, travel party, travel reason and the hotel reply. The author has only the first name and the age group. Page with limit and offset, total is the number of reviews. A hotel without reviews returns an empty list, an unknown hotel id returns 404.</p>

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

## 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` | string | Yes | HolidayCheck hotel UUID from the autocomplete or hotels endpoint. Example: 90a9d6db-5941-446f-91ba-9a4a2893ab95. |
| `limit` | integer | No | Reviews per page, 1 to 50. Defaults to 20. |
| `offset` | integer | No | Number of reviews to skip, 0 to 5000. Defaults to 0. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": "855a19d2-a88d-4bd9-9211-48c7cd60e2bb",
                "text": "Wundersch\u00f6ne Lage an der Steilk\u00fcste, tolles Essen und sehr nettes Personal. Wir waren mit allem sehr zufrieden!",
                "title": "Sch\u00f6ne Lage mit hervorragendem Essen und freundlichem Personal",
                "author": {
                    "age_group": "FROM_56_TO_60",
                    "first_name": "Cati"
                },
                "ratings": {
                    "HOTEL": {
                        "GENERAL": 6
                    },
                    "GENERAL": {
                        "GENERAL": 6
                    }
                },
                "entry_date": "2026-09-27T08:57:22Z",
                "recommended": true,
                "travel_date": "2026-09-01T00:00:00Z",
                "travel_reason": "BEACH",
                "traveled_with": "COUPLE"
            }
        ],
        "limit": 1,
        "total": 110,
        "offset": 0,
        "has_more": true,
        "hotel_id": "90a9d6db-5941-446f-91ba-9a4a2893ab95"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "reviews"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Hotel Not Found | The requested HolidayCheck hotel does not exist. 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)