>

roomesto.com · English

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

ParameterVerplichtFormaat en limieten
destinationjaNaam van stad of regio, 2 tot 80 tekens, bijvoorbeeld Dubai, Istanbul, Paris (het beste in het Engels).
checkinjaDatum YYYY-MM-DD: vandaag of later (UTC), maximaal 365 dagen vooruit.
checkoutjaDatum YYYY-MM-DD, na de aankomst; maximaal 30 nachten.
adultsnee, standaard 2Geheel getal van 1 tot 6.
children_agesneeLeeftijden van kinderen met komma's gescheiden, 0 tot 17, maximaal 4 kinderen, bijvoorbeeld 5,12.
currencynee, standaard USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_priceneePrijs per nacht in de gekozen valuta, van 0 tot 100000.
limitnee, standaard 10Geheel getal van 1 tot 20.
langnee, standaard enTaal 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

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:

Gebruiksregels

Andere toegangen