# Holidu Property Detail API Documentation
Holidu Property Detail API Documentation Get one property with price, description, amenities, house rules, rooms, bed types, capacity, check-in and check-out times, certificates, reasons to book, breadcrumbs, photos and location. Host contact data is not returned.
- **Documentation:** [https://scrappa.co/docs/holidu-api/holidu_property](https://scrappa.co/docs/holidu-api/holidu_property)
- **API group:** Holidu API
- **Endpoint:** `GET https://scrappa.co/api/holidu/property`
## 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. |
| `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": {
"market": "com",
"property": {
"id": "63793870",
"url": "https://www.holidu.com/d/63793870",
"tags": [],
"usps": [
{
"id": "USP_PEOPLE",
"unit": null,
"group": "PEOPLE",
"value": 2,
"format": "NUMBER"
},
{
"id": "USP_BED_ROOM",
"unit": null,
"group": "LAYOUT",
"value": 1,
"format": "NUMBER"
}
],
"dates": null,
"likes": null,
"price": {
"ccy": "USD",
"daily": 107,
"total": 107,
"nights": null,
"currency": "USD",
"is_exact": false,
"discount_type": null,
"discount_amount": null,
"discount_percentage": null,
"discount_description": null,
"strike_through_daily": null,
"strike_through_total": null
},
"rooms": [
{
"id": "bed_1",
"type": "BEDROOM",
"amenities": [
{
"id": "BED_QUEEN",
"count": 1,
"group": "BED",
"value": "Queensize bed",
"format": "STRING"
}
],
"room_index": 0
}
],
"photos": [
{
"tags": [
"LIVING_ROOM",
"INSIDE"
],
"large": "https://img.holidu.com/images/0c36dc2e-0ccb-4794-8118-a6665a49d01c/l.jpg",
"medium": "https://img.holidu.com/images/0c36dc2e-0ccb-4794-8118-a6665a49d01c/m.jpg",
"overlay": false,
"high_res": "https://img.holidu.com/images/0c36dc2e-0ccb-4794-8118-a6665a49d01c/hr.jpg",
"thumbnail": "https://img.holidu.com/images/0c36dc2e-0ccb-4794-8118-a6665a49d01c/t.jpg"
},
{
"tags": [
"LIVING_ROOM",
"INSIDE"
],
"large": "https://img.holidu.com/images/dda288b4-16cb-4662-b02e-dd35cd34150e/l.jpg",
"medium": "https://img.holidu.com/images/dda288b4-16cb-4662-b02e-dd35cd34150e/m.jpg",
"overlay": false,
"high_res": "https://img.holidu.com/images/dda288b4-16cb-4662-b02e-dd35cd34150e/hr.jpg",
"thumbnail": "https://img.holidu.com/images/dda288b4-16cb-4662-b02e-dd35cd34150e/t.jpg"
}
],
"rating": {
"count": 36,
"value": 90
},
"details": {
"area": {
"unit": "UNIT_SF",
"value": 237
},
"name": "GuestReady - Cozy Parisian Escape for 2",
"original": null,
"bed_types": null,
"long_name": null,
"unit_name": null,
"pets_count": null,
"short_name": [
"237 ft\u00b2",
"Apartment"
],
"description": "We are GuestReady, a property manager, and we want to ensure your stay will be as smooth and comfortable as possible. We are available 24/7 should you need any ",
"name_parent": null,
"guests_count": 2,
"apartment_type": "APARTMENT",
"bedrooms_count": 1,
"short_description": null,
"description_parent": null,
"apartment_type_name": null,
"apartment_type_title": "Entire apartment",
"description_language": "EN",
"out_side_description": "The Clignancourt district, located in the 18th arrondissement of Paris, is known for its famous flea market, the Puces de Saint-Ouen. Explore this giant market ",
"alternative_long_name": null,
"description_in_paragraphs": "We are GuestReady, a property manager, and we want to ensure your stay will be as smooth and comfortable as possible.
We are available 24/7 should yo",
"is_cached_machine_translation": false
},
"filters": {
"amenities": []
},
"reviews": [
{
"id": "63793550-1374980",
"rating": 4,
"comment": {
"title": "Tutto sommato a casa spaziosa. Era abbastanza pulita, non perfetto",
"general": null,
"language": "IT",
"negative": "La difficolt\u00e0 di prendere la chiave.\nE non c'\u00e8 nessuna ti consegna l'appartamento. Le finestre nel bagno e nelle camere non si possono aprire su due camere.",
"positive": "La zona \u00e8 abbastanza tranquilla, anche se pur in centro di grossi codomini."
},
"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-04-01",
"rating_details": [
{
"ACCOMMODATION": 4
},
{
"CLEANLINESS": 4
}
],
"is_holidu_review": true,
"rating_details_v2": [
{
"id": "ACCOMMODATION",
"rating": 4
},
{
"id": "CLEANLINESS",
"rating": 4
}
],
"translated_comment": null
}
],
"group_id": "61393870",
"location": {
"lat": 48.8952769,
"lng": 2.3386141,
"name": "Paris, Ile de France",
"geo_hash": "u09wjjngtsjp",
"distance_to_search_region_center": {
"id": null,
"unit": "UNIT_MI",
"value": 1.2,
"format": "NUMBER_WITH_UNIT"
},
"distance_to_original_search_region_center": null
},
"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",
"statistics": {
"review_count": 2000,
"review_score": 4.65,
"count_of_bookings": null,
"only_express_bookable": true,
"only_instant_bookable": true
},
"is_premium_partner": false
},
"sou_tags": [
{
"id": "ALMOST_BOOKED_OUT",
"value": "Almost booked out. We recommend you book soon."
}
],
"amenities": {
"AMENITY_GENERAL": [
{
"id": "INTERNET_WIFI",
"group": "INTERNET",
"value": "Wi-Fi",
"format": "STRING"
},
{
"id": "INTERNET",
"group": "INTERNET",
"value": "Internet",
"format": "STRING"
}
],
"AMENITY_KITCHEN": [
{
"id": "KITCHEN",
"group": "KITCHEN",
"value": "Kitchen",
"format": "STRING"
},
{
"id": "MICROWAVE",
"group": "MICROWAVE",
"value": "Microwave",
"format": "STRING"
}
],
"AMENITIES_POPULAR": [
{
"id": "INTERNET_WIFI",
"group": "INTERNET",
"value": "Wi-Fi",
"format": "STRING"
}
],
"AMENITY_IMPORTANT": [
{
"id": "INTERNET_WIFI",
"group": "INTERNET",
"value": "Wi-Fi",
"format": "STRING"
},
{
"id": "INTERNET",
"group": "INTERNET",
"value": "Internet",
"format": "STRING"
}
]
},
"discounts": [],
"video_url": null,
"breadcrumbs": [
{
"id": 1175,
"url": "/s/France",
"name": "France",
"level": 4,
"prefix": null
},
{
"id": 21594,
"url": "/s/Ile-de-France--France",
"name": "Ile de France",
"level": 8,
"prefix": null
}
],
"guest_cards": [],
"house_rules": {
"pets": {
"value": "Pets not allowed",
"is_allowed": false
},
"smoking": {
"value": "Smoking not allowed",
"is_allowed": false
},
"open_times": null,
"youth_group": null,
"barrier_free": null,
"home_owner_location": null
},
"sou_tags_v2": [
{
"id": "ALMOST_BOOKED_OUT",
"value": "Almost booked out. We recommend you book soon."
}
],
"usps_parent": [],
"amenities_v2": {
"AMENITY_GENERAL": [
{
"id": "INTERNET_WIFI",
"group": "INTERNET",
"value": "Wi-Fi",
"format": "STRING"
},
{
"id": "INTERNET",
"group": "INTERNET",
"value": "Internet",
"format": "STRING"
}
],
"AMENITY_KITCHEN": [
{
"id": "KITCHEN",
"group": "KITCHEN",
"value": "Kitchen",
"format": "STRING"
},
{
"id": "MICROWAVE",
"group": "MICROWAVE",
"value": "Microwave",
"format": "STRING"
}
],
"AMENITIES_POPULAR": [
{
"id": "INTERNET_WIFI",
"group": "INTERNET",
"value": "Wi-Fi",
"format": "STRING"
}
],
"AMENITY_IMPORTANT": [
{
"id": "INTERNET_WIFI",
"group": "INTERNET",
"value": "Wi-Fi",
"format": "STRING"
},
{
"id": "INTERNET",
"group": "INTERNET",
"value": "Internet",
"format": "STRING"
}
]
},
"amenities_v3": {
"AMENITY_KITCHEN": [
{
"id": "KITCHEN",
"group": "KITCHEN",
"value": "Kitchen",
"format": "STRING"
},
{
"id": "MICROWAVE",
"group": "MICROWAVE",
"value": "Microwave",
"format": "STRING"
}
],
"AMENITY_BATHROOM": [
{
"id": "HAIRDRYER",
"group": "HAIRDRYER",
"value": "Hairdryer",
"format": "STRING"
},
{
"id": "SHOWER",
"group": "SHOWER",
"value": "Shower",
"format": "STRING"
}
],
"AMENITY_ENTERTAINMENT": [
{
"id": "INTERNET_WIFI",
"group": "INTERNET",
"value": "Wi-Fi",
"format": "STRING"
},
{
"id": "INTERNET",
"group": "INTERNET",
"value": "Internet",
"format": "STRING"
}
],
"AMENITY_BEDROOM_AND_LAUNDRY": [
{
"id": "WASHER",
"group": "WASHER",
"value": "Washing machine",
"format": "STRING"
},
{
"id": "BEDLINEN",
"group": "BEDLINEN",
"value": "Bedlinen",
"format": "STRING"
}
],
"AMENITY_HEATING_AND_COOLING": [
{
"id": "HEATING",
"group": "HEATING",
"value": "Heating",
"format": "STRING"
}
],
"AMENITY_HEALTHCARE_AND_SAFETY": [
{
"id": "SMOKE_DETECTOR",
"group": "SMOKE_DETECTOR",
"value": "Smoke detector",
"format": "STRING"
}
],
"AMENITY_PROPERTY_FEATURES_AND_PARKING": [
{
"id": "ENTRANCE_PRIVATE",
"group": "ENTRANCE_PRIVATE",
"value": "Private entrance",
"format": "STRING"
}
]
},
"certificates": [],
"good_to_know": [
{
"id": "SUITABLE_CHILDREN",
"value": "Suitable for children"
}
],
"is_available": null,
"is_multiunit": true,
"is_star_host": false,
"routing_type": "CHECKOUT",
"is_searchable": true,
"provider_usps": [],
"house_rules_v2": {
"checkin": "From 3:00\u202fPM to 10:00\u202fPM",
"checkout": "Until 11:00\u202fAM",
"house_rules": [
{
"type": "PETS",
"value": "Pets not allowed",
"is_allowed": false
},
{
"type": "SMOKING",
"value": "Smoking not allowed",
"is_allowed": false
}
]
},
"html_meta_data": {
"image": "https://img.holidu.com/images/0c36dc2e-0ccb-4794-8118-a6665a49d01c/t.jpg",
"title": "GuestReady - Cozy Parisian Escape for 2",
"description": "Vacation apartment, M\u00e9tropole du Grand Paris, Paris, France, 2 Guests, 1 bedroom, 1 Bathroom"
},
"review_extract": null,
"reviews_quotes": [
{
"quote": "The property is within easy walking distance to a variety of cafes, lower-priced take-away restaurants, and grocery stores in the neighborhood."
},
{
"quote": "I definitely recommend staying here :)"
}
],
"characteristics": [
{
"id": "PETS",
"unit": null,
"value": "no",
"format": "STRING"
},
{
"id": "SMOKING",
"unit": null,
"value": "no",
"format": "STRING"
}
],
"missing_filters": null,
"reasons_to_book": [
{
"id": "TOP_RATED_HOST",
"icon": "PERFECT_MATCH",
"value": "Exceptional hospitality",
"description": "Guests appreciate the welcoming atmosphere and friendly service."
},
{
"id": "FULLY_EQUIPPED_KITCHEN",
"icon": "AMENITIES_KITCHEN",
"value": "Well-equipped kitchen",
"description": "Cook delicious meals in a well-equipped kitchen."
}
],
"seo_breadcrumbs": [
{
"id": 1175,
"url": "/vacation-rentals/france",
"name": "France",
"level": 4,
"prefix": "in"
},
{
"id": 21594,
"url": "/vacation-rentals/france/ile-de-france",
"name": "Ile de France",
"level": 8,
"prefix": null
}
],
"additional_rules": {
"groups": null,
"parties": null,
"children": null,
"for_events": null,
"event_wedding": null,
"long_term_stays": null,
"event_stag_party": null,
"event_baby_shower": null,
"event_birth_day_adult": null,
"event_birth_day_child": null
},
"amenities_parent": null,
"checkin_checkout": {
"checkin_times": [
{
"to": "22:00",
"from": "15:00"
}
],
"checkout_times": [
{
"to": "11:00",
"from": null
}
]
},
"ski_resort_names": [],
"capacity_rules_v2": {
"kids": null,
"adults": {
"label": "over 0 years of age",
"max_age": null,
"min_age": 0,
"max_number": 2,
"age_requested": false
},
"min_adults": 1
},
"is_test_apartment": false,
"popular_amenities": [
{
"id": "INTERNET_WIFI",
"group": "INTERNET",
"value": "Wi-Fi",
"format": "STRING"
},
{
"id": "TV",
"group": "TV",
"value": "TV",
"format": "STRING"
}
],
"house_rules_parent": null,
"cancellation_policy": {
"free_cancellation": {
"amount": null,
"percentage": null,
"until_date": null,
"days_before_arrival": 14
},
"light_cancellation": null
},
"essential_amenities": [
{
"id": "TOWELS",
"group": "TOWELS",
"value": "Towels",
"format": "STRING"
},
{
"id": "BEDLINEN",
"group": "BEDLINEN",
"value": "Bedlinen",
"format": "STRING"
}
],
"good_to_know_parent": null,
"holidu_check_review": null,
"is_express_bookable": true,
"is_instant_bookable": true,
"enriched_description": null,
"provider_trader_data": {
"is_certified": true,
"registration_number": "811804681"
},
"essential_amenities_v2": [
{
"id": "INTERNET_WIFI",
"group": "INTERNET",
"value": "Wi-Fi",
"format": "STRING"
},
{
"id": "TV",
"group": "TV",
"value": "TV",
"format": "STRING"
}
],
"not_included_amenities": [],
"reasons_to_book_parent": [],
"alternative_price_rates": [],
"essential_amenities_parent": null,
"holidu_check_photos_message": null,
"guest_cards_and_certificates": [],
"supports_parent_unit_structure": false,
"is_multi_unit_bookability_enabled": false
}
},
"meta": {
"billable": true,
"endpoint_family": "property_detail"
},
"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 offer id is unknown or the property is no longer listed. 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)