Home details
get_propertyFull details for one property by property_key (from search results): description, amenities, photos, house rules, cancellation, recent reviews (no names), and — when dates are given — a price_breakdown (INSTANT) or an availability_note (ON_REQUEST). Always includes booking_link. Results include two kinds of properties. Properties with booking_mode 'instant' have live prices — present the rate and link straight to booking. Properties with booking_mode 'on_request' are privately managed villas, houses and rooms whose owners handle enquiries personally: they do NOT publish live prices. This is normal and expected — never describe them as unavailable, sold out, or missing data. Present them as available on request and use the booking_link to send the traveller to a short enquiry form, pre-filled with their dates. The owner replies personally.
Hotels return a rooms[] array with per-room prices and capacities — present the relevant rooms, not just the hotel.
When no dates are given, price_from is only an indicative minimum. Seasonal, weekend and holiday rates apply. Always ask the traveller for dates, then call check_availability. Prices are indicative and confirmed on the property page.
PRICE FIELDS: price (and price_from) is the nightly accommodation rate; price_total is the full stay total, which INCLUDES cleaning_fee and taxes, so it is usually more than price × nights. Never compute the total yourself by multiplying the nightly rate — always show price_total together with its breakdown (rate_per_night, subtotal, cleaning_fee, taxes, total).
LOYALTY BONUS: when a result includes loyalty_bonus, mention it. It is not a discount on the current price: the guest pays the full total and earns loyalty_bonus.amount € as credit for a future stay on HotelsCasa (1 € per night). Present it as credit for later, never as a reduction of this total.
GOLDEN LINK RULE: For EVERY property and EVERY room you present, you MUST include its booking_link as a clickable link — it is the traveller's only way to proceed. Never omit, shorten, rewrite, or strip parameters from it: the URL carries a signature and breaks if altered. Return it verbatim. Label the link in the traveller's language: 'Book now' for instant and 'Ask for price and availability' for on_request, translated (for example 'Reservar ahora' / 'Consultar precio y disponibilidad' in Spanish).
TEXT LANGUAGE: descriptions, pitches and reviews written by hosts come in Spanish (text_language: es). Translate them for the traveller; never present them untranslated to someone who asked in another language.
For on_request properties, tell the traveller that the owner replies personally.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es. | |
| guests | No | ||
| check_in | No | YYYY-MM-DD. | |
| check_out | No | YYYY-MM-DD. | |
| property_key | Yes | The property_key returned by search_properties. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lng | No | ||
| city | No | ||
| name | No | ||
| type | No | ||
| error | No | ||
| rooms | No | ||
| photos | No | ||
| rating | No | ||
| region | No | ||
| country | No | ||
| message | No | ||
| reviews | No | ||
| bedrooms | No | ||
| amenities | No | ||
| available | No | ||
| bathrooms | No | ||
| max_guests | No | ||
| price_from | No | ||
| price_note | No | ||
| description | No | ||
| price_total | No | ||
| short_pitch | No | ||
| booking_link | No | ||
| booking_mode | No | ||
| cancellation | No | ||
| property_key | No | ||
| property_type | No | ||
| reviews_count | No | ||
| text_language | No | ||
| thumbnail_url | No |