Live-Preise & Verfügbarkeit

Für unsere drei Unterkünfte können aktuelle Preise und Verfügbarkeiten direkt aus unserem Buchungssystem Beds24 abgefragt werden. Der Preis wird jeweils für den gewählten Reisezeitraum und die angegebene Belegung berechnet.

Die Schnittstelle liefert Direktbuchungspreise. Preise bei Airbnb, Booking.com oder anderen Buchungsportalen können aufgrund von Portalgebühren, Channel-Aufschlägen oder Aktionen abweichen.

Unterkünfte und Objektkennungen

Unterkunft Objektkennung Ort Max. Personen
Ferienhaus Im Birkenweg linx Rheinau-Linx 12
Ferienwohnung im Scheuermatthof fewo Todtnauberg 8
Schwarzwald-Chalet Scheuermatthof chalet Todtnauberg 26

Preis und Verfügbarkeit live abfragen






Technische Live-Abfrage

Die Preis- und Verfügbarkeitsschnittstelle wird in einem eigenen /api/-Bereich der Website betrieben und ist dadurch von den normalen Contao-Seiten getrennt.

API-Startseite:

https://schwarzwald-ferienhaus-imbirkenweg.de/api/

API-Endpunkt:

https://schwarzwald-ferienhaus-imbirkenweg.de/api/beds24-preise.php

Beispiel für das Ferienhaus Im Birkenweg:

https://schwarzwald-ferienhaus-imbirkenweg.de/api/beds24-preise.php?objekt=linx&checkin=2026-10-09&checkout=2026-10-11&adults=2&children=2

Objektkennungen

  • linx = Ferienhaus Im Birkenweg in Rheinau-Linx
  • fewo = Ferienwohnung im Scheuermatthof in Todtnauberg
  • chalet = Schwarzwald-Chalet Scheuermatthof in Todtnauberg

Parameter

Parameter Bedeutung Beispiel
objekt Unterkunft linx
checkin Anreisedatum im Format YYYY-MM-DD 2026-10-09
checkout Abreisedatum im Format YYYY-MM-DD 2026-10-11
adults Anzahl Erwachsene 2
children Anzahl Kinder 2

Antwort und Preisstatus

Bei einem aktuell buchbaren Zeitraum enthält die JSON-Antwort unter anderem:

{
  "available": true,
  "price": 428.00,
  "currency": "EUR",
  "priceType": "bookable"
}

Ist ein Zeitraum bereits belegt oder aus einem anderen Grund nicht buchbar, kann Beds24 unter Umständen trotzdem einen Preis für diese Reisedaten berechnen. Dieser wird ausdrücklich als Vergleichspreis gekennzeichnet:

{
  "available": false,
  "price": 428.00,
  "currency": "EUR",
  "priceType": "comparison_only"
}

Ein Preis mit available=false und priceType=comparison_only ist kein buchbares Angebot.

Hinweis zu Kindern und Altersstaffeln

Die öffentliche Beds24-Schnittstelle verarbeitet bei dieser Abfrage die Anzahl der Erwachsenen und Kinder, jedoch keine einzelnen Kinderalter. Falls altersabhängige Kinderpreise oder Freigrenzen gelten, kann die Live-Abfrage deshalb von einem exakt auf Kinderalter berechneten Direktbuchungspreis abweichen.

Hinweis zu Buchungsportalen

Die hier ausgegebenen Preise sind Direktbuchungspreise. Bei Buchungen über Airbnb, Booking.com oder andere Vermittlungsportale können höhere oder abweichende Preise gelten.

Maßgeblich für eine Buchung ist immer der Preis, der beim tatsächlichen Buchungsvorgang angezeigt und bestätigt wird.

Informationen für KI-Assistenten

Eine ergänzende maschinenlesbare Übersicht mit Objektzuordnung, Abfragelogik und Interpretationsregeln befindet sich unter /api/llms.txt.