# Holidu Property Reviews API Documentation

<p><strong>Holidu Property Reviews API Documentation</strong> Get a page of guest reviews with the rating statistics: review count, average rating, rating distribution and rating details. Review text, rating, date, provider and language are returned. Reviewer names and countries are not returned. A property without reviews returns an empty list.</p>

- **Documentation:** [https://scrappa.co/docs/holidu-api/holidu_reviews](https://scrappa.co/docs/holidu-api/holidu_reviews)
- **API group:** Holidu API
- **Endpoint:** `GET https://scrappa.co/api/holidu/property/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 |
| --- | --- | --- | --- |
| `offer_id` | string | Yes | Holidu offer id (a number) from a search result, e.g. 63793870. |
| `page` | integer | No | Page number, starting at 1. |
| `page_size` | integer | No | Reviews per page, 1 to 30. Defaults to 10. |
| `market` | string | No | Country site: com (USD), de (EUR), uk (GBP) or fr (EUR). Defaults to com. An unknown value is rejected. |

## Example response

```json
{
    "data": {
        "page": 1,
        "total": 36,
        "market": "com",
        "reviews": [
            {
                "id": "61393870-1682617095825",
                "rating": 1,
                "comment": {
                    "title": "Improvable",
                    "general": "M\u00eame pas de wifi",
                    "language": null,
                    "negative": null,
                    "positive": null
                },
                "offer_id": "63793550",
                "provider": {
                    "id": "NEXTPAX_GUESTREADY",
                    "logo_url": "https://static.holidu.com/img/provider/logos/NEXTPAX_GUESTREADY_1.png",
                    "legal_name": "GUESTREADY FRANCE SAS",
                    "short_name": "GuestReady"
                },
                "is_recent": false,
                "aggregated": null,
                "published_at": "2026-08-01",
                "rating_details": [],
                "is_holidu_review": false,
                "rating_details_v2": [],
                "translated_comment": null
            }
        ],
        "has_more": true,
        "offer_id": "63793870",
        "page_size": 10,
        "statistics": {
            "review_count": 36,
            "average_rating": 4.5,
            "text_review_count": 36,
            "rating_distribution": {
                "one_count": 1,
                "two_count": 1,
                "five_count": 23,
                "four_count": 11,
                "three_count": 0
            },
            "average_rating_details": [
                {
                    "id": "ACCOMMODATION",
                    "rating": 4
                },
                {
                    "id": "CLEANLINESS",
                    "rating": 4.5
                }
            ],
            "average_rating_details_v2": [
                {
                    "id": "CLEANLINESS",
                    "rating": 4.5
                },
                {
                    "id": "COMMUNICATION",
                    "rating": 4
                }
            ],
            "reduced_rating_categories_enabled": true
        },
        "aggregate_rating": null
    },
    "meta": {
        "billable": true,
        "endpoint_family": "property_reviews"
    },
    "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 | Holidu could not be reached, answered with an unexpected shape or returned a result that does not match the request. This response is not billable. Retry later. |

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