Search accommodations
search_accommodationsPaginated holiday accommodation search over directly bookable/inquirable own inventory (externally managed listings are not exposed). Filter by region (regionId from autocomplete_regions), a radius around a point (lat/lng/radiusKm — use the coordinates of the place the user names; results then carry distanceKm and can be sorted by distance) or a map bounding box (neLat/neLng/swLat/swLng); these three are mutually exclusive. Travel dates (arrival/departure, both together; add bookableOnly to drop stays below the minimum stay), persons (a minimum: beds ≥ persons — add personsMax to exclude oversized houses; optional adults split for families — children can use extra-children slots), bedrooms, bathrooms, livingSpaceMin (m²), minReviews, price range per night, feature codes (e.g. swimming_pool, wifi, pets_allowed), accommodation types and offers. Sort: relevance (default), rating (best first; website formula, a single 5.0 review outranks many 4.8s — use minReviews), persons, bedrooms, living_area, distance (radius searches). Every result carries url (the listing page on the website of the locale) and, on dated searches, stayUrl with dates and guests pre-filled — give these to the user as the link. location.place is the actual town; location.region is the (marketing) region it is listed under. Dated searches include a stayPrice per result: the exact total for the stay incl. mandatory costs and discounts (kind "total"; "min_stay" when the stay is below the minimum), or "from"/"on_request" where only the static basePrice or no price is available. approximate: true means some nights were priced from the owner's base price; the website confirms the final total.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Search centre latitude | |
| lng | No | Search centre longitude | |
| page | No | ||
| sort | No | relevance | |
| neLat | No | Bounding box north-east latitude | |
| neLng | No | Bounding box north-east longitude | |
| query | No | Keyword search over names and descriptions in the response language and the German originals | |
| swLat | No | Bounding box south-west latitude | |
| swLng | No | Bounding box south-west longitude | |
| types | No | ||
| adults | No | Adults among persons; when below persons, objects may host the remainder as extra children (website guests widget parity) | |
| locale | No | Language the user is writing in (de, en, fr, pl, it, es, nl, hr); defaults to de. Selects the language of names and texts in the response and the language region names are matched in — pass it on every call. | de |
| offers | No | ||
| arrival | No | ||
| perPage | No | ||
| persons | No | Minimum sleeping places (beds ≥ persons); combine with personsMax to cap size | |
| bedrooms | No | ||
| features | No | ||
| priceMax | No | Omit for unbounded — no sentinel values | |
| priceMin | No | Per night with dates, base price without | |
| radiusKm | No | Radius around the centre in km (as the crow flies), max 300 | |
| regionId | No | Region to search in (from /regions/autocomplete); omit to search everywhere | |
| bathrooms | No | ||
| departure | No | ||
| minReviews | No | Only accommodations with at least this many visible reviews | |
| personsMax | No | Maximum sleeping places (beds ≤ personsMax); excludes oversized houses | |
| bookableOnly | No | Dated searches only: keep only stays that meet the minimum stay (drops stayPrice.kind "min_stay" results) | |
| livingSpaceMin | No | Minimum living space in m² |