Ferienhaus API

Die Ferienhaus API stellt oeffentliche Objektinformationen als JSON bereit. KI-Agenten und andere automatisierte Systeme koennen damit Ferienhaeuser suchen und Detailinformationen abrufen, ohne die Website-Oberflaeche auslesen zu muessen.

Es ist keine Authentifizierung erforderlich. Die Endpoints akzeptieren GET und HEAD. Antworten werden fuer 5 Minuten zwischengespeichert und enthalten den Header X-Robots-Tag: noindex, damit rohe JSON-Endpunkte nicht indexiert werden.

Endpoints

KI-Agent Discovery

Zusaetzlich zur HTML-Dokumentation gibt es maschinenlesbare Dateien fuer Agenten, Tools und MCP-Clients.

Suchfelder abrufen

Verwende diesen Endpoint zuerst, um zu sehen, welche Parameter und Listenwerte fuer die Suche erlaubt sind. Fuer Listenfilter wird der Wert aus value in der Suchanfrage verwendet.

curl "https://www.schweden-ferienhaeuser.de/api/object-fields"

Beispiel Antwort

{
"parameters": {
"region": {
"label": "Region",
"type": "list",
"multiple": true,
"values": [
{ "label": "Smaland", "value": "smaland" }
]
},
"equipment": {
"label": "Ausstattung",
"type": "list",
"multiple": true,
"values": [
{ "label": "WLAN", "value": "wlan" },
{ "label": "Sauna", "value": "sauna" }
]
}
}
}

Objekte suchen

curl "https://www.schweden-ferienhaeuser.de/api/objects?region=smaland&guests=4&start=2026-07-01&end=2026-07-08"

Beispiel Antwort

{
"results": [
{
"id": "1234",
"title": "Ferienhaus am See",
"description": "Kurzbeschreibung des Objekts...",
"url": "https://www.schweden-ferienhaeuser.de/ferienhaus/ferienhaus-am-see/",
"api_url": "https://www.schweden-ferienhaeuser.de/api/object/1234/",
"availability_url": "https://www.schweden-ferienhaeuser.de/api/object-availability/1234/?start=2026-07-01&end=2026-07-08&guests=1",
"image": "https://www.schweden-ferienhaeuser.de/wp-content/uploads/object-photo.jpg",
"rating": 4.8,
"review_count": 12,
"category": "Ferienhaus",
"region": "Smaland",
"place": "Vimmerby",
"max_people": 6,
"bedroom_count": 3,
"living_space": 95,
"equipment": [ "WLAN", "Sauna" ],
"highlights": [ "WLAN", "Sauna" ],
"price": {
"total": 980,
"currency": "EUR",
"start": "2026-07-01",
"end": "2026-07-08"
}
}
],
"total": 1,
"page": 1,
"per_page": 100,
"total_pages": 1
}

Objekt Details

{id-or-slug} kann die sichtbare Objekt-ID oder der URL-Slug des Objekts sein.

curl "https://www.schweden-ferienhaeuser.de/api/object/1234/"

Verfuegbarkeit pruefen

Der Preis enthaelt die verpflichtenden Bestandteile und weist separat aus, ob Kurtaxe oder Kaution nicht enthalten sind.

curl "https://www.schweden-ferienhaeuser.de/api/object-availability/1234/?start=2026-07-01&end=2026-07-08&guests=1"

Beispiel Antwort

{
"object_id": "1234",
"available": true,
"start": "2026-07-01",
"end": "2026-07-08",
"guests": 4,
"currency": "EUR",
"checkout_url": "https://www.schweden-ferienhaeuser.de/booking-checkout/?step=1&object_id=1234&booking_start=2026-07-01&booking_end=2026-07-08&booking_guests=4",
"price": {
"total": 980,
"regular_total": 1120,
"is_offer": true,
"nights": 7,
"min_nights": 5,
"included": [ "Endreinigung" ],
"included_notes": [],
"excluded": [ "Kurtaxe" ],
"note": "Preis zzgl. Kurtaxe."
}
}

Fehlerantworten

Hinweise

• Listenfilter wie region, equipment oder category verwenden die value-Werte aus https://www.schweden-ferienhaeuser.de/api/object-fields.
• Wenn start und end uebergeben werden, werden nicht buchbare Objekte herausgefiltert und die Antwort enthaelt einen Gesamtpreis.
• Die API ist nur lesend. Buchungen oder Anfragen koennen ueber diese Endpunkte nicht erstellt werden.