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
| Parameter | Pflichtfeld | Format und Grenzen |
|---|---|---|
destination | ja | Stadt- oder Regionsname, 2 bis 80 Zeichen, zum Beispiel Dubai, Istanbul, Paris (am besten auf Englisch). |
checkin | ja | Datum YYYY-MM-DD: heute oder später (UTC), höchstens 365 Tage im Voraus. |
checkout | ja | Datum YYYY-MM-DD, nach der Anreise; höchstens 30 Nächte. |
adults | nein, Standard 2 | Ganze Zahl von 1 bis 6. |
children_ages | nein | Alter der Kinder durch Kommas getrennt, 0 bis 17, höchstens 4 Kinder, zum Beispiel 5,12. |
currency | nein, Standard USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | nein | Preis pro Nacht in der gewählten Währung, von 0 bis 100000. |
limit | nein, Standard 10 | Ganze Zahl von 1 bis 20. |
lang | nein, Standard en | Sprache 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
- Hotels in Dubai für zwei Personen, 10. bis 15. November 2026, bis 150 USD pro Nacht, JSON:
https://roomesto.com/ai/hotels?destination=Dubai&checkin=2026-11-10&checkout=2026-11-15&adults=2¤cy=USD&max_price=150&format=json - Familie mit zwei Erwachsenen und einem 7-jährigen Kind in Istanbul, HTML-Seite:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
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:
hotel:id,name,star_rating,address(Name und Adresse könnennullsein, wenn die Hotelkarte nicht in unseren lokalen Daten liegt).room:namedes günstigsten Zimmertarifs für die Daten und der Verpflegungstypmeal(room_only,breakfast,half_board,full_board,all_inclusiveund andere).price:totalfür den gesamten Aufenthalt,per_nightundcurrency.taxes:included_in_price(true, false oder null, wenn unbekannt) undnot_included— Steuern und Gebühren, die separat gezahlt werden, meist im Hotel, mit eigenem Betrag und eigener Währung.payment:typeistpay_now(Zahlung auf der Buchungsseite) oderpay_at_hotel.cancellation:typeistfree_until(mit Zeitpunktfree_untilin UTC),partial,non_refundableoderunknown;penaltieslistet die Beträge nach Zeitraum.availability:statusavailable,checked_at(wann die Suche lief, UTC) undrequires_recheck= true: Preis und Zimmer werden auf der Buchungsseite bestätigt.booking_url: die Buchungsseite von roomesto.com mit denselben Daten, Gästen und derselben Währung.
Regeln für die Nutzung
- Zeigen Sie Preise zusammen mit Datum, Währung und Zeitpunkt
checked_at: Bis zur Buchung können sie sich ändern. - Zeigen Sie die Steuern aus
not_includedneben dem Preis. Istincluded_in_pricenull, sagen Sie, dass die Steuern unbekannt sind. - Führen Sie Reisende über den Link
booking_url. Buchung und Zahlung erfolgen auf roomesto.com. - Ergebnisseiten sind mit
noindexmarkiert; für die Indexierung sind diese Seite und die Dokumentation gedacht. - Limit: 120 Anfragen pro Minute pro IP-Adresse. Der übliche Verkehr von KI-Assistenten liegt weit unter dieser Grenze.
- Der Dienst liefert keine personenbezogenen Daten und keine Kontoinformationen.
Weitere Zugänge
- MCP-Server für Clients, die ihn unterstützen: Anleitung zur Verbindung.
- Hotelratgeber: Artikel.