Hotelzoeken voor AI-assistenten
roomesto.com beantwoordt hotelzoekopdrachten met actuele prijzen en beschikbaarheid via een gewoon GET-verzoek. Een account, API-sleutel, cookies, JavaScript of MCP-client is niet nodig. Dezelfde zoekmachine draait op de site.
Adres van het verzoek
GET https://roomesto.com/ai/hotels geeft een HTML-resultatenpagina die zonder JavaScript leesbaar is. Voeg format=json toe (of vraag /ai/hotels.json op, of stuur Accept: application/json) voor gestructureerde JSON.
Parameters
| Parameter | Verplicht | Formaat en limieten |
|---|---|---|
destination | ja | Naam van stad of regio, 2 tot 80 tekens, bijvoorbeeld Dubai, Istanbul, Paris (het beste in het Engels). |
checkin | ja | Datum YYYY-MM-DD: vandaag of later (UTC), maximaal 365 dagen vooruit. |
checkout | ja | Datum YYYY-MM-DD, na de aankomst; maximaal 30 nachten. |
adults | nee, standaard 2 | Geheel getal van 1 tot 6. |
children_ages | nee | Leeftijden van kinderen met komma's gescheiden, 0 tot 17, maximaal 4 kinderen, bijvoorbeeld 5,12. |
currency | nee, standaard USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | nee | Prijs per nacht in de gekozen valuta, van 0 tot 100000. |
limit | nee, standaard 10 | Geheel getal van 1 tot 20. |
lang | nee, standaard en | Taal van de pagina en de 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 de leverancierstaal en, ru, de, es, fr, tr, it; anders in het Engels). |
Voorbeelden
- Hotels in Dubai voor twee personen, 10 tot 15 november 2026, tot 150 USD per 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 - Een gezin met twee volwassenen en een kind van 7 in Istanbul, HTML-pagina:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
JSON-antwoord
status is een van ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, met een lijst errors van param en message) of provider_unavailable (503: geen resultaten en geen prijzen, er wordt niets geraden als de zoekopdracht bij de leverancier mislukt).
data_status laat zien waar de resultaten vandaan komen: live — de zoekopdracht is net uitgevoerd; cached — een recente zoekopdracht wordt hergebruikt; stale — een oudere zoekopdracht terwijl nieuwe beperkt zijn; partial — de leverancier stuurde nog hotels toen de wachttijd afliep (in hotels_received staat hoeveel hotels er binnenkwamen; zo'n antwoord wordt niet gecacht, herhaal hetzelfde verzoek later).
Elk element van results bevat:
hotel:id,name,star_rating,address(naam en adres kunnennullzijn als de hotelkaart niet in onze lokale gegevens staat).room:namevan het goedkoopste kamertarief voor de datums en het maaltijdplanmeal(room_only,breakfast,half_board,full_board,all_inclusiveen andere).price:totalvoor het hele verblijf,per_nightencurrency.taxes:included_in_price(true, false of null als het onbekend is) ennot_included— belastingen of kosten die apart worden betaald, meestal in het hotel, met eigen bedrag en valuta.payment:typeispay_now(betaling op de boekingspagina) ofpay_at_hotel.cancellation:typeisfree_until(met het tijdstipfree_untilin UTC),partial,non_refundableofunknown;penaltiesvermeldt de bedragen per periode.availability:statusavailable,checked_at(wanneer de zoekopdracht liep, UTC) enrequires_recheck= true: prijs en kamer worden bevestigd op de boekingspagina.booking_url: de boekingspagina van roomesto.com met dezelfde datums, gasten en valuta.
Gebruiksregels
- Toon prijzen samen met de datum, valuta en het tijdstip
checked_at: ze kunnen vóór de boeking veranderen. - Toon de belastingen uit
not_includednaast de prijs. Isincluded_in_pricenull, zeg dan dat de belastingen onbekend zijn. - Stuur de reiziger naar de link
booking_url. Boeken en betalen gebeurt op roomesto.com. - Resultatenpagina's zijn gemarkeerd met
noindex; deze pagina en de documentatie zijn bedoeld voor indexering. - Limiet: 120 verzoeken per minuut per IP-adres. Gewoon AI-assistentverkeer blijft ver onder deze limiet.
- De dienst geeft geen persoonsgegevens en geen accountinformatie terug.
Andere toegangen
- MCP-server voor clients die dit ondersteunen: handleiding voor verbinden.
- Hotelgidsen: artikelen.