Hotel-API

Hotelsuche, Tarife und Buchung

Ziel auflösen, Häuser listen, Tarif prüfen und bestätigen. Ein REST-Ablauf, Preise in USD.

POST /v2/Hotel/HotelAvailability
{
  "CheckIn": "2026-11-14",
  "CheckOut": "2026-11-16",
  "CityId": 11111111456928,
  "Occupancies": [ { "AdultCount": 2 } ],
  "Sort": "price"
}
Überblick

Der Hotelbestand ist riesig und Tarife ändern sich schnell. Diese Unterkunfts-API bietet öffentliche Ortssuche, Verfügbarkeit im Stadt- und Hotel-Modus, Tarifprüfung mit Haltefenster und einen klaren Ablauf: erst buchen, dann bestätigen.

Eine Beherbergungs-API steht vor Millionen von Unterkünften, von globalen Ketten bis zu unabhängigen Boutiquehotels. Verfügbarkeit, Verpflegungsarten, Stornobedingungen und Steuern kommen in einer einzigen Form und Währung, sodass Ihre Hotelbuchungs-Website oder App nie ein Dutzend Lieferantenformate abgleichen muss.

Das bekommen Sie

1

Die öffentliche Ortssuche lässt sich direkt an ein Autocomplete-Feld anbinden.

2

Ein Verfügbarkeits-Endpunkt listet eine ganze Stadt oder öffnet ein einzelnes Hotel mit seinen Zimmern.

3

Tarif prüfen, Zimmer halten, dann bestätigen und abbuchen, alles in USD.

4

Stadt- und Hotelsuche aus einem Endpunkt, von einem ganzen Reiseziel bis zu einer einzelnen Unterkunft.

5

Die Tarifprüfung öffnet ein kurzes Haltefenster, damit der angezeigte Preis der Buchungspreis ist.

So läuft der Ablauf

01

Resolve

Turn a destination string into a place id with public place search.

02

Search

List availability for a whole city, or open a single property with its rooms.

03

Validate

Confirm the live rate and open a short hold window.

04

Book

Place the order and confirm; your balance is charged on confirmation.

Wichtige Endpunkte

GET/Hotel/PlaceSearchResolve a destination into a place id.
POST/v2/Hotel/HotelAvailabilityList availability in city or hotel mode.
POST/Hotel/RateValidateValidate the selected rate and hold it.
POST/Hotel/HotelBookCreate and confirm the booking.
GET/Hotel/BookingDetailsRetrieve a booking and its status.

Anfrage und Antwort

Request · POST /v2/Hotel/HotelAvailability
{
  "CheckIn": "2026-11-14",
  "CheckOut": "2026-11-16",
  "CityId": 11111111456928,
  "Occupancies": [ { "AdultCount": 2 } ],
  "Sort": "price"
}
Response · 200 OK
{
  "hotels": [
    {
      "hotelId": "HTL-9931",
      "name": "Marina Suites",
      "stars": 4,
      "lowestRate": {
        "amount": 180.00, "currency": "USD", "board": "BB"
      },
      "rooms": [ { "code": "DLX-K", "refundable": true } ]
    }
  ]
}

Was die Antwort enthält

hotelId
Stable id for the property.
lowestRate
Cheapest bookable rate, in USD, with board type.
rooms
Room options with codes and refundability.
cancellationPolicy
Deadlines and penalties that apply to the rate.
hold
Minutes the validated rate stays bookable.
5 Mio.+

Hotels weltweit

Häufige Fragen

Wie mache ich aus einem Ziel eine Suche?

Rufen Sie die öffentliche Ortssuche auf, um den Text in eine ID aufzulösen, und übergeben Sie diese ID an die Verfügbarkeit.

Wie lange gilt ein geprüfter Tarif?

Fünfzehn Minuten. Buchen Sie innerhalb dieses Fensters mit dem zurückgegebenen Tarifcode.

Wann wird mein Guthaben belastet?

Erst wenn Sie die Bestellung aufgeben. Die Buchung hält das Zimmer, ohne zu belasten.

Enthalten die Raten Steuern und Gebühren?

Ja. Jede Rate trägt Währung, Verpflegungsart und eine Aufschlüsselung von Steuern und Gebühren, alles auf USD normalisiert.

Kann ich eine einzelne Unterkunft direkt öffnen?

Ja. Der Hotelmodus öffnet eine Unterkunft mit ihren Zimmern, der Stadtmodus listet ein ganzes Reiseziel.

Bauen Sie Ihr Reiseprodukt auf einer API.

Kostenlos integrieren. 1 % pro ausgestelltem Ticket, gedeckelt bei 10 $. Live-Abdeckung für Flüge, Hotels und Aktivitäten.