Buchungstool per Link vorbelegen: die URL-Parameter der Buchungsseite
Welche Parameter die Buchungsseite in der URL annimmt, um Einheit, Zeitraum und Gästezahl vorzubelegen.
Aktualisiert am 19. Oktober 2026
Buchungstool per Link vorbelegen
Die Buchungsseite (/de/book/<token> bzw. deine Slug-Adresse) nimmt Parameter in der URL entgegen. Damit landet ein Gast, der auf deiner eigenen Website schon Zeitraum und Personenzahl gewählt hat, mit einem Klick im fertig vorbelegten Buchungstool.
Beispiel:
/de/book/TOKEN?unit=UUID&checkin=2026-11-02&checkout=2026-11-08&adults=4&children=1&infants=1&dogs=1&autoSearch=true
Mit Zeitraum und Gästezahl vorbelegte Buchungsseite
Die Parameter
| Parameter | Bedeutung |
|---|---|
unit |
Die UUID der Einheit, die vorausgewählt werden soll |
checkin / arrival |
Anreisedatum als JJJJ-MM-TT. Beide Schreibweisen sind gleichwertig |
checkout / departure |
Abreisedatum als JJJJ-MM-TT. Beide Schreibweisen sind gleichwertig |
adults |
Anzahl Erwachsene |
children |
Anzahl Kinder |
infants |
Anzahl Kleinkinder |
dogs |
Anzahl Hunde. Wirkt nur, wenn Hunde in den Gästekategorien des Buchungstools aktiviert sind |
cluster |
Schränkt die Auswahl auf eine Einheiten-Gruppe ein (siehe Einheiten-Gruppierung) |
autoSearch=true |
Startet die Suche sofort, statt nur die Felder zu füllen |
browse=true |
Öffnet direkt den Unterkunfts-Katalog statt der Suchmaske |
embed=true |
Einbettungs-Modus, wenn du die Seite selbst in deine Website einbindest |
bg=ffffff |
Hintergrundfarbe als Hex-Wert ohne # |
lang=de |
Sprache, nur beim Link ohne Sprachkürzel (/book/<token>). /de/book/... legt die Sprache schon fest |
Die vollständige Liste mit Beispielen für deine Webagentur steht auch in der API-Dokumentation unter https://rest.myxentra.com/docs im Abschnitt „Website integration".
Wo finde ich die UUID einer Einheit?
Xentra zeigt die UUID an keiner Stelle der Oberfläche an. Es gibt zwei Wege:
- Der fertige Link pro Wohnung. Öffne deine Buchungsseite und klick die Wohnung an. Die Adresse im Browser ist dann die eigene Adresse dieser Wohnung (
/de/book/<Kürzel>/<Land>/<Ort>/<Wohnung>) und lässt sich direkt kopieren. Für die meisten Website-Baukästen reicht dieser Link. Rufst du die Seite mit?unit=<UUID>auf, schreibt das Buchungstool die Adresse ohnehin auf diesen Pfad um. - Über die Daten-API.
GET /api/v1/propertiesliefert zu jeder Wohnung das Feldid, und das ist genau die UUID, die der Parameteruniterwartet.
Braucht dein Anbieter zwingend die reine ID und hast du keinen API-Schlüssel, melde dich bei uns unter hello@support.myxentra.com, dann schicken wir dir die Liste.
Wofür es keine Parameter gibt
- Rabattcode: den gibt der Gast im Buchungstool selbst ein, er lässt sich nicht über die URL setzen.
- Zusatzleistungen: die werden erst im Online-Check-in angeboten, nicht im Buchungstool. Eine Vorauswahl über die URL gibt es deshalb nicht.
Gästezahl
Liegt die Gästezahl im Link über der Grenze einer Einheit, zeigt das Buchungstool bei dieser Einheit „Maximale Gästezahl: N" statt eines Preises. Wo du die Grenze setzt, steht im Artikel „Buchungstool" unter „Gästezahl, Zeiten und Mindestaufenthalt".