Live-Demo

Unterkunfts-API

Eine Unterkunfts-API für Hotels, Apartments und Ferienunterkünfte

Eine Unterkunfts-API bringt jede Art von Unterkunft auf Ihre Buchungsseite: Hotelzimmer, Serviced Apartments, Ferienhäuser, Hostels und Pensionen. Diese Seite erklärt die Daten hinter einem Aufenthalt, die Regeln, die Ferienunterkünfte von Hotels unterscheiden, und wie PHPTRAVELS Ihre eigenen Objekte und den Bestand von Lieferanten in einer Suche verkauft.

  • Objekt, Einheit, Rate, Kalender
  • Mindestaufenthalt und Gebühren
  • Stornofristen
  • Eigener Bestand plus API-Angebot

Das Datenmodell

Vier Ebenen in jedem Aufenthalt

Ob Hotel mit 300 Zimmern oder einzelnes Strandhaus: Eine Unterkunfts-API beschreibt es in denselben vier verschachtelten Ebenen. Jede Ebene beantwortet eine andere Frage, die sich Gäste vor der Buchung stellen.

01Objekt

Die Unterkunft selbst: Name, Typ, Adresse und Kartenposition, Fotos, Ausstattung, Sterne oder Qualitätsstufe, Hausregeln und Check-in-Zeiten.

property_id · type · address · geo · photos · amenities · check_in_from

02Zimmer oder Einheit

Was tatsächlich gebucht wird: eine Zimmerkategorie, ein ganzes Apartment oder ein Bett im Schlafsaal, mit Größe, Betten und maximaler Belegung.

unit_id · beds · size_m2 · max_adults · max_children

03Tarif

Wie die Einheit verkauft wird: Verpflegung, Stornobedingungen, Zahlungsbedingungen und wer sie buchen darf, etwa öffentlich oder nur für Agenten.

rate_plan_id · board · cancel_policy · payment · channel

04Verfügbarkeit

Eine Zeile pro Nacht: Preis, verbleibende Einheiten, Mindestaufenthalt und ob an diesem Tag An- oder Abreise möglich ist.

date · price · units_left · min_stay · closed_to_arrival

Ein Gebäude, ein Zimmer, ein Preisschild und ein Kalender als getrennte, gestapelte Ebenen eines Unterkunftsangebots

PHPTRAVELS nennt sein Unterkunftsmodul Stays, weil dasselbe Modell weit mehr als Hotels abdeckt. Ein Objekt enthält Einheiten, eine Einheit wird über einen oder mehrere Tarife verkauft, und jeder Tarif hat einen Kalender mit Preis und Verfügbarkeit pro Nacht. Wenn diese vier Ebenen stimmen, passen ein Hostelbett, eine Hotelsuite und eine Villa mit drei Schlafzimmern in dieselbe Suche und denselben Checkout.

Lieferanten benennen die Ebenen unterschiedlich, und manche fassen zwei zusammen, doch die Struktur ist immer vorhanden. Das Unterkünfte bildet jede Quelle darauf ab, sodass der Gast eine einheitliche Seite sieht.

Nacht für Nacht

Im Verfügbarkeitskalender entscheidet sich, ob ein Aufenthalt gebucht wird

Jede Unterkunfts-API endet in einem Kalender. Die Suche liefert ein Objekt nur dann, wenn jede Nacht des gewünschten Aufenthalts frei, mit Preis versehen und nach den Aufenthaltsregeln erlaubt ist.

Zwei-Zimmer-Apartment · StandardtarifNovember 2026 · Preis pro Nacht
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Frei, Preis pro Nacht
  • Bereits gebucht
  • Vom Eigentümer gesperrt
  • Mindestaufenthalt ab dieser Anreise
  • Anreise gesperrt

Beispieldaten, vereinfacht

  • Preise gelten pro NachtDer Gesamtpreis ist die Summe aller Nächte, daher kosten Freitag und Samstag zu Wochenendpreisen mehr als zwei Wochentage. Tages- und Saisonpreise stehen im Kalender, nicht am Objekt.
  • Regeln zum MindestaufenthaltEin Mindestaufenthalt von drei Nächten bei Anreise am Freitag blendet die Einheit bei einer Suche über zwei Nächte aus. Ferienunterkünfte nutzen solche Regeln weit häufiger als Hotels, oft strenger am Wochenende und in der Hochsaison.
  • Anreise oder Abreise gesperrtEine Nacht kann Teil eines längeren Aufenthalts sein, aber nicht die erste oder letzte Nacht. Wechseltage bei Ferienhäusern funktionieren so.
  • Gesperrte Nächte und Stop-SellEigentümer sperren Termine für Eigennutzung oder Wartung, und ein Stop-Sell nimmt eine Einheit sofort aus dem Verkauf. Jede gesperrte Nacht im gewünschten Zeitraum entfernt die Einheit aus den Ergebnissen.

Nicht jede Unterkunft ist ein Hotel

Hotels, Apartments und Ferienunterkünfte im Vergleich

Das Datenmodell ist dasselbe, aber jede Unterkunftsart füllt es anders. Das sind die Unterschiede, die Ihr Buchungsablauf abdecken muss, wenn Sie mehr als Hotelzimmer verkaufen.

Hotels

Auch Hostels und Pensionen

Was gebucht wird
Eine Zimmerkategorie mit vielen gleichen Zimmern oder ein Bett im Schlafsaal.
Preisgestaltung
Ein Nachtpreis pro Zimmer und Verpflegung; zusätzliche Erwachsene oder Kinder können ihn ändern.
Aufenthaltsregeln
Mindestaufenthalt nur zu Spitzenterminen; die meisten Nächte lassen sich einzeln buchen.
Gebühren und Kautionen
Kurtaxe oder Tourismusabgabe, manchmal eine Resortgebühr vor Ort.
Anreise
Eine rund um die Uhr oder personell besetzte Rezeption; Check-in-Zeiten auf dem Voucher genügen.
Typische Quelle
Bedbanks und Großhändler, Direktverträge, Channel-Manager.

Serviced Apartments

Aparthotels und Stadtapartments

Was gebucht wird
Ein Einheitentyp, oft mit Küche und getrennten Schlafzimmern.
Preisgestaltung
Ein Nachtpreis pro Einheit, mit Wochen- oder Monatspreisen für lange Aufenthalte.
Aufenthaltsregeln
Mindestaufenthalte sind üblich, und lange Aufenthalte machen einen großen Teil der Nachfrage aus.
Gebühren und Kautionen
Eine Reinigungsgebühr pro Aufenthalt und eine erstattbare Kaution sind üblich.
Anreise
Die Rezeptionszeiten variieren; späte Ankunft braucht einen Schlüsseltresor oder Code.
Typische Quelle
Channel-Manager, Direktverträge und einige Großhändler.

Ferienunterkünfte

Ferienhäuser, Villen und Hütten

Was gebucht wird
Ein bestimmtes Haus. Es gibt meist nur eines davon.
Preisgestaltung
Ein Nachtpreis für das ganze Haus, plus Aufschlag pro zusätzlichem Gast über einer Grundbelegung.
Aufenthaltsregeln
Mindestaufenthalt, feste Wechseltage und gesperrte Anreisetage sind die Regel.
Gebühren und Kautionen
Reinigungsgebühr, erstattbare Schadenskaution und örtliche Steuern, jeweils vor der Zahlung angezeigt.
Anreise
Check-in-Anweisungen, Adresse und Kontakt werden vor der Anreise gesendet, nie auf der öffentlichen Seite.
Typische Quelle
Eigentümer und Verwalter, direkt oder über einen Channel-Manager.

Sie verkaufen Unterkünfte vieler Gastgeber statt eigener Verträge? Das ist ein Marktplatz, beschrieben auf der Seite BnB-Portal.

Fenster der Stornobedingungen

Eine Buchung, drei Stornofenster

Eine Stornobedingung ist eine Zeitleiste, die vom Anreisedatum zurückgerechnet wird. Jedes Fenster legt fest, was der Gast bei einer Stornierung darin zurückerhält.

BuchungCheck-in
  1. 01 · Bis 14 Tage vor AnreiseKostenlose StornierungDer Gast storniert und erhält den vollen Betrag zurück. Diese Frist suchen Reisende zuerst, also zeigen Sie sie als Datum, nicht als Regel.
  2. 02 · 14 bis 3 Tage vorherTeilweise GebührEs fällt eine Gebühr an, oft die erste Nacht oder ein Prozentsatz des Aufenthalts. Ferienunterkünfte behalten in diesem Fenster ggf. die Kaution.
  3. 03 · Letzte 3 Tage und NichterscheinenNicht erstattbarDer volle Betrag wird einbehalten. Als nicht erstattbar verkaufte Tarife beginnen in diesem Fenster ab dem Moment der Buchung.
Beispielfenster; jeder Tarif hat seine eigenen.
  • Pro Tarif, nicht pro ObjektDasselbe Apartment kann einen flexiblen und einen günstigeren nicht erstattbaren Tarif haben, die Bedingung gehört also zur Tarifebene.
  • Daten in der Zeitzone des Objekts"14 Tage vorher" wird ab dem Anreisedatum am Ort der Unterkunft gezählt. Rechnen Sie es auf der Seite und im Voucher in ein klares Datum mit Uhrzeit um.
  • Es gilt die Bedingung des LieferantenBei API-Bestand können Sie keine milderen Bedingungen anbieten als Ihr Lieferant. Bei eigenen Verträgen legen Sie die Fenster selbst fest.

Eigener Bestand und API-Bestand

Ihre vertraglich gebundenen Objekte und Lieferanten-APIs in einer Suche

Die meisten Anbieter von Unterkünften machen beides: Sie laden die selbst kontrahierten Objekte und ergänzen den Rest über Lieferanten-APIs. Der Reisende sollte nie merken, woher ein Aufenthalt stammt.

Ihre eigenen Objekte

  • Objekte, Einheiten und Tarife selbst im Admin anlegen
  • Eigentümern und Hotels einen Extranet-Zugang für ihren Kalender geben
  • Preise, Mindestaufenthalte, gesperrte Tage und Stornofenster festlegen
  • Kontingente mit Release-Tagen und Stop-Sell
  • Oder Preise und Verfügbarkeit von einem Channel-Manager erhalten

Lieferanten-API-Bestand

  • Große Kataloge in Zielen, die Sie nie selbst kontrahieren könnten
  • Live-Preise und Verfügbarkeit zum Suchzeitpunkt
  • Verpflegung, Bedingungen und Gebühren des Lieferanten bei jeder Rate
  • Aktiviert mit Ihrem eigenen Lieferantenvertrag und Ihren Zugangsdaten
  • Buchung und Stornierung gehen direkt an den Lieferanten

Was der Gast bekommt

  • Eine Ergebnisliste mit einer Objektseite pro Unterkunft
  • Dasselbe Zimmer aus mehreren Quellen nur einmal, zu Ihrem Preis
  • Ihre Aufschläge nach Lieferant, Ziel oder Kanal sowie B2B-Agentenpreise
  • Ein Voucher-Format, egal welche Quelle bestätigt hat

Die Anbindung eines Channel-Managers steht auf Channel-Manager-Integration. Für Zimmer, die Sie unter Vertrag halten, siehe Buchungs-Inventarsystem.

Bereit in PHPTRAVELS

Bereits angebundene Stays-Lieferanten

Diese Unterkunftslieferanten sind heute mit dem Stays-Modul verbunden. Sie schließen den Vertrag mit dem Lieferanten, tragen Ihre eigenen Zugangsdaten im Admin ein, testen in dessen Sandbox und gehen live. Die Liste kommt live aus unserem Integrationsverzeichnis.

Sie brauchen einen Lieferanten, der nicht aufgeführt ist, etwa ein regionales Ferienhaus-Netzwerk? Jede Unterkunfts-API mit Dokumentation lässt sich ergänzen, siehe Individuelle API-Integration. Zu Lieferantentypen und Content-Mapping lesen Sie die Seite Hotel-API, und die beiden größten Bedbank-Leitfäden: RateHawk-API-Integration und Hotelbeds API-Integration.

Buchen Sie eine Unterkunft so, wie Ihre Gäste es tun

Suchen, Preise vergleichen und buchen Sie in der Live-Demo, und sagen Sie uns dann, welche Objekte und Lieferanten Sie verkaufen möchten.

Live-Demo testenFragen zu Ihren Lieferanten

Sie bauen eine eigene App oder einen Partner-Feed? Die PHPTRAVELS REST API liefert jede angebundene Stays-Quelle in einem Format, mit Webhooks für Buchungsereignisse. Sie ist im Enterprise-Tarif enthalten, siehe Preise und die Entwicklerdokumentation. Das Gesamtbild finden Sie auf Reise-APIs.

FAQ

Unterkunfts-API: Fragen von Entwicklern und Agenturen

Vertrieb kontaktieren

Eine Unterkunfts-API ist eine Sammlung von Webdiensten, mit denen eine Buchungsseite Unterkünfte durchsucht, Preise und Verfügbarkeit für bestimmte Daten und Gäste liest sowie Buchungen anlegt, abruft und storniert. Sie deckt Hotels und jede andere Unterkunftsart ab: Apartments, Ferienunterkünfte, Hostels und Pensionen.

Die Kernaufrufe sind gleich. Eine Unterkunfts-API muss zusätzlich bewältigen, was Nicht-Hotels brauchen: Buchung ganzer Einheiten, Mindestaufenthalt und Wechseltage, Aufpreise für zusätzliche Gäste, Reinigungsgebühren, erstattbare Kautionen und Check-in-Anweisungen vor der Anreise.

Ja. In PHPTRAVELS nutzt das Stays-Modul für jede Unterkunftsart ein Modell aus Objekt, Einheit, Tarif und Verfügbarkeit, sodass Hotels, Apartments und Ferienhäuser mit ihren eigenen Regeln in derselben Suche erscheinen.

Jede Nacht im Kalender kann eine Mindestaufenthaltsdauer tragen, meist an das Anreisedatum gebunden. Sucht ein Gast weniger Nächte als das Minimum, wird die Einheit nicht geliefert. Kennzeichen für gesperrte Anreise und gesperrte Abreise funktionieren bei Wechseltagen genauso.

Ja. Sie können Objekte, Einheiten, Tarife und Kalender selbst anlegen, Eigentümern einen Extranet-Zugang geben oder Preise von einem Channel-Manager erhalten und sie neben dem Lieferantenbestand in einer Ergebnisliste verkaufen.

Aus dem Tarif. Lieferantenbestand trägt die Bedingung des Lieferanten, Ihre eigenen Objekte nutzen die von Ihnen festgelegten Fenster. Die Frist wird dem Gast vor der Zahlung angezeigt und auf den Voucher gedruckt.

Nein. Sie schließen mit jedem Unterkunftslieferanten selbst einen Vertrag und tragen Ihre eigenen Zugangsdaten im Admin ein. PHPTRAVELS liefert die Buchungsplattform, das Stays-Modul und die fertigen Konnektoren.

Ja. Im Enterprise-Tarif stellt die PHPTRAVELS REST API Suche und Buchung über alle angebundenen Quellen in einem Format bereit, mit Webhooks für Buchungsereignisse und vollem Quellcode zur Erweiterung.

Eine PHPTRAVELS-Lizenz, Ihre eigene Domain und mindestens eine Bestandsquelle: selbst kontrahierte Objekte, einen Channel-Manager oder einen Lieferantenvertrag mit einem Unterkunftsgroßhändler. Die Live-Demo zeigt zuerst den gesamten Ablauf.

Weiter entdecken

Mehr zur Plattform