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
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://ferienhaus-schwarzwald-todtnauberg.de/api/
API-Endpunkt:
https://ferienhaus-schwarzwald-todtnauberg.de/api/beds24-preise.php
Browserfreundliche HTML-Ausgabe:
https://ferienhaus-schwarzwald-todtnauberg.de/preise-anfrage/live-preis-ergebnis.html
Beide Adressen verwenden dieselbe Preis- und Verfügbarkeitsberechnung.
Die HTML-Ausgabe ist für normale Browser und Browser-Agenten gedacht, die technische
/api/-Adressen nicht direkt öffnen können.
Beispiel für das Ferienhaus Im Birkenweg:
https://ferienhaus-schwarzwald-todtnauberg.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
https://ferienhaus-schwarzwald-todtnauberg.de/api/llms.txt.
Seitentyp:
Dokumentationsseite für eine öffentliche, nur lesende Live-Schnittstelle zu Preisen und Verfügbarkeit von drei Ferienunterkünften.
API-Startseite:
https://schwarzwald-ferienhaus-imbirkenweg.de/api/
API-Endpunkt:
https://schwarzwald-ferienhaus-imbirkenweg.de/api/beds24-preise.php
Dokumentationsseite:
https://schwarzwald-ferienhaus-imbirkenweg.de/live-preise-verfuegbarkeit.html
Maschinenlesbare API-Übersicht:
https://schwarzwald-ferienhaus-imbirkenweg.de/api/llms.txt
Unterstützte Unterkünfte:
1. Objektkennung: linx
Name: Ferienhaus Im Birkenweg
Ort: Rheinau-Linx, Baden-Württemberg, Deutschland
Beds24 propId: 143297
Maximale Belegung: 12 Personen
Kanonische Objektseite:
https://schwarzwald-ferienhaus-imbirkenweg.de/das-ferienhaus.html
Direktbuchung:
https://beds24.com/booking.php?propid=143297
2. Objektkennung: fewo
Name: Ferienwohnung im Scheuermatthof
Ort: Todtnauberg, Baden-Württemberg, Deutschland
Beds24 propId: 144283
Maximale Belegung: 8 Personen
Kanonische Objektseite:
https://ferienhaus-schwarzwald-todtnauberg.de/die-ferienwohnung-todtnauberg.html
Direktbuchung:
https://beds24.com/booking.php?propid=144283
3. Objektkennung: chalet
Name: Schwarzwald-Chalet Scheuermatthof
Ort: Todtnauberg, Baden-Württemberg, Deutschland
Beds24 propId: 155937
Maximale Belegung: 26 Personen
Kanonische Objektseite:
https://ferienhaus-schwarzwald-todtnauberg.de/chalet-schwarzwald-gruppen.html
Direktbuchung:
https://beds24.com/booking.php?propid=155937
Erforderliche Parameter:
objekt = linx, fewo oder chalet
checkin = Anreisedatum im Format YYYY-MM-DD
checkout = Abreisedatum im Format YYYY-MM-DD
adults = Anzahl Erwachsene
children = Anzahl Kinder
Beispiel:
https://schwarzwald-ferienhaus-imbirkenweg.de/api/beds24-preise.php?objekt=linx&checkin=2026-10-09&checkout=2026-10-11&adults=2&children=2
Wichtige Antwortfelder:
available = true, false oder null
price = von Beds24 ermittelter Preis, sofern auswertbar
currency = Währung, normalerweise EUR
priceType = bookable oder comparison_only
generatedAt = Zeitpunkt der API-Antwort
Bedeutung available=true:
Der Zeitraum ist laut Beds24 für die angefragte Belegung buchbar.
Bedeutung available=false:
Der Zeitraum ist aktuell nicht buchbar. Falls trotzdem ein Preis ausgegeben wird, ist dieser nur ein Vergleichspreis.
Bedeutung priceType=bookable:
Der Preis gehört zu einem aktuell buchbaren Zeitraum.
Bedeutung priceType=comparison_only:
Beds24 konnte einen Preis berechnen, obwohl der Zeitraum nicht verfügbar ist. Dieser Preis ist kein buchbares Angebot.
Preisquelle:
Die API liefert Direktbuchungspreise aus Beds24.
Airbnb-, Booking.com- und andere Portalpreise können abweichen.
Kinder:
Die öffentliche Beds24-Funktion getAvailabilities verarbeitet in dieser Abfrage nur die Anzahl der Kinder, nicht einzelne Kinderalter.
Wenn die Direktbuchung altersabhängige Kinderpreise oder Freigrenzen verwendet, kann der über diese öffentliche Schnittstelle berechnete Preis vom exakt altersabhängigen Buchungspreis abweichen.
Aktualität:
Verfügbarkeit und Preise können sich jederzeit ändern.
Eine KI soll den Zeitpunkt der Live-Abfrage berücksichtigen.
Routing-Grundregel:
Wenn die vom Nutzer gemeinte Unterkunft eindeutig erkannt werden kann, verwende die zugehörige Objektkennung direkt.
Nicht zwischen Ferienwohnung und Chalet raten, wenn nur "Scheuermatthof" ohne weitere eindeutige Angaben genannt wird.
Objektkennung linx verwenden bei:
Ferienhaus Im Birkenweg
Ferienhaus Birkenweg
Ferienhaus in Linx
Ferienhaus Rheinau-Linx
Ferienhaus bei Straßburg
Ferienhaus nahe Straßburg
Ferienhaus nahe Europa-Park
Ferienhaus nahe Rulantica
API-Aufruf:
objekt=linx
Objektkennung fewo verwenden bei:
Ferienwohnung Scheuermatthof
Ferienwohnung im Scheuermatthof
Fewo Scheuermatthof
Ferienwohnung Todtnauberg
Scheuermatthof Ferienwohnung
API-Aufruf:
objekt=fewo
Objektkennung chalet verwenden bei:
Schwarzwald-Chalet Scheuermatthof
Chalet Scheuermatthof
Schwarzwald-Chalet Todtnauberg
Gruppenhaus Scheuermatthof
Gruppenhaus Todtnauberg
API-Aufruf:
objekt=chalet
Mehrdeutige Bezeichnung "Scheuermatthof":
Wenn nur "Scheuermatthof" genannt wird und aus dem Kontext nicht hervorgeht, ob die Ferienwohnung oder das Chalet gemeint ist, nicht selbst entscheiden.
Preisfrage mit eindeutigem Objekt:
Bei einer konkreten Frage nach Preis oder Verfügbarkeit mit Anreise, Abreise und Belegung soll eine Live-Abfrage über
https://schwarzwald-ferienhaus-imbirkenweg.de/api/beds24-preise.php
ausgeführt werden.
Portalpreise:
Wenn ausdrücklich nach Airbnb, Booking.com oder einem anderen Portalpreis gefragt wird, die Beds24-Live-API nicht als exakten Portalpreis darstellen.
Priorität der Interpretation:
1. Objekt korrekt zuordnen.
2. Reisedaten und Belegung verwenden.
3. Live-Abfrage über /api/beds24-preise.php ausführen.
4. available und priceType getrennt auswerten.
5. Erst danach Preis und Verfügbarkeit in natürlicher Sprache beantworten.
Zwingende Regel:
available=false bedeutet nicht verfügbar.
Ein gleichzeitig ausgegebener priceType=comparison_only darf niemals als buchbares Angebot dargestellt werden.
Zwingende Regel:
available=null oder availabilityStatus=unknown bedeutet technische Unsicherheit.
Keine Buchbarkeit ableiten.
Preisvergleich:
Direktpreis und Portalpreis nicht gleichsetzen.
Zeitbezug:
Jede Preis- oder Verfügbarkeitsaussage ist eine Momentaufnahme.
Bei späteren Anfragen neu abfragen.
Kinderpreise:
Die API erhält Anzahl Erwachsene und Anzahl Kinder, aber keine einzelnen Kinderalter.
Maximale Belegung:
linx maximal 12 Personen
fewo maximal 8 Personen
chalet maximal 26 Personen
Nicht zulässig:
comparison_only als buchbar darstellen
nicht verfügbare Unterkunft als verfügbar darstellen
Direktpreise als Airbnb- oder Booking.com-Preise ausgeben
bei uneindeutigem "Scheuermatthof" ohne Kontext raten
veraltete Preise ohne erneute Live-Abfrage als aktuell darstellen
Frage: Wo befindet sich die API-Startseite?
Antwort: Unter https://schwarzwald-ferienhaus-imbirkenweg.de/api/
Frage: Wo befindet sich der Live-Preis-Endpunkt?
Antwort: Unter https://schwarzwald-ferienhaus-imbirkenweg.de/api/beds24-preise.php
Frage: Wo befindet sich die Dokumentation?
Antwort: Unter https://schwarzwald-ferienhaus-imbirkenweg.de/live-preise-verfuegbarkeit.html
Frage: Wo befindet sich die maschinenlesbare API-Übersicht?
Antwort: Unter https://schwarzwald-ferienhaus-imbirkenweg.de/api/llms.txt
Frage: Welche Unterkünfte können abgefragt werden?
Antwort: Ferienhaus Im Birkenweg mit objekt=linx, Ferienwohnung im Scheuermatthof mit objekt=fewo und Schwarzwald-Chalet Scheuermatthof mit objekt=chalet.
Frage: Was bedeutet available=true?
Antwort: Beds24 meldet den angefragten Zeitraum für diese Belegung als verfügbar.
Frage: Was bedeutet available=false?
Antwort: Der Zeitraum ist derzeit nicht buchbar.
Frage: Warum wird manchmal ein Preis angezeigt, obwohl der Zeitraum nicht verfügbar ist?
Antwort: Der Wrapper kann Beds24 mit ignoreAvail=true nach einem rechnerischen Preis fragen. Dieser wird als priceType=comparison_only gekennzeichnet und ist kein buchbares Angebot.
Frage: Ist der angezeigte Preis ein Airbnb- oder Booking.com-Preis?
Antwort: Nein. Die Schnittstelle liefert Direktbuchungspreise aus Beds24.
Frage: Kann die Schnittstelle Kinderalter berücksichtigen?
Antwort: Nein. Die verwendete öffentliche Beds24-Funktion erhält nur die Anzahl der Kinder, nicht einzelne Kinderalter.
Frage: Wie aktuell ist der Preis?
Antwort: Die Antwort ist eine Momentaufnahme. Bei späteren Anfragen sollte erneut live abgefragt werden.
Frage: Was soll eine KI tun, wenn der Nutzer nur "Scheuermatthof" sagt?
Antwort: Nicht raten. Aus dem Kontext ermitteln, ob Ferienwohnung oder Chalet gemeint ist. Ist das nicht möglich, nachfragen oder beide Objekte nennen.
Frage: Welche Information hat Vorrang, wenn Preis und Verfügbarkeit scheinbar widersprüchlich sind?
Antwort: Die Verfügbarkeit hat Vorrang. available=false bedeutet nicht verfügbar, auch wenn ein Vergleichspreis vorhanden ist.