>

roomesto.com · English

Hotelsuche für KI-Assistenten

roomesto.com beantwortet Hotelanfragen mit aktuellen Preisen und Verfügbarkeit über eine einfache GET-Anfrage. Konto, API-Schlüssel, Cookies, JavaScript und MCP-Client sind nicht nötig. Dieselbe Suchmaschine läuft auf der Website.

Adresse der Anfrage

GET https://roomesto.com/ai/hotels liefert eine HTML-Ergebnisseite, die ohne JavaScript lesbar ist. Fügen Sie format=json hinzu (oder rufen Sie /ai/hotels.json auf oder senden Sie Accept: application/json), um strukturiertes JSON zu erhalten.

Parameter

ParameterPflichtfeldFormat und Grenzen
destinationjaStadt- oder Regionsname, 2 bis 80 Zeichen, zum Beispiel Dubai, Istanbul, Paris (am besten auf Englisch).
checkinjaDatum YYYY-MM-DD: heute oder später (UTC), höchstens 365 Tage im Voraus.
checkoutjaDatum YYYY-MM-DD, nach der Anreise; höchstens 30 Nächte.
adultsnein, Standard 2Ganze Zahl von 1 bis 6.
children_agesneinAlter der Kinder durch Kommas getrennt, 0 bis 17, höchstens 4 Kinder, zum Beispiel 5,12.
currencynein, Standard USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_priceneinPreis pro Nacht in der gewählten Währung, von 0 bis 100000.
limitnein, Standard 10Ganze Zahl von 1 bis 20.
langnein, Standard enSprache der Seite und der Hotelnamen: en, ru, de, es, fr, tr, it, zh, ar, ja, ko, pt, nl, sv, no, da, fi, pl, cs, el, he, hi, id, th, vi, uk, ro (Hotelnamen in den Anbietersprachen en, ru, de, es, fr, tr, it, sonst Englisch).

Beispiele

Antwort im JSON-Format

status ist einer von ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, mit einer Liste errors aus param und message) oder provider_unavailable (503: keine Ergebnisse und keine Preise, nichts wird geraten, wenn die Suche beim Anbieter ausfällt).

data_status zeigt die Herkunft der Ergebnisse: live — die Suche wurde gerade ausgeführt; cached — eine kürzliche Suche wird wiederverwendet; stale — eine ältere Suche, solange frische Suchen begrenzt sind; partial — der Anbieter lieferte noch Hotels, als die Wartezeit ablief (in hotels_received steht, wie viele Hotels eingetroffen sind; eine solche Antwort wird nicht zwischengespeichert, wiederholen Sie die Anfrage später).

Jedes Element von results enthält:

Regeln für die Nutzung

Weitere Zugänge