>

roomesto.com · English

Hotellsøk for AI-assistenter

roomesto.com svarer på hotellsøk med live priser og tilgjengelighet gjennom en vanlig GET-forespørsel. Konto, API-nøkkel, informasjonskapsler, JavaScript eller MCP-klient er ikke nødvendig. Den samme søkemotoren driver nettstedet.

Adresse for forespørselen

GET https://roomesto.com/ai/hotels returnerer en HTML-resultatside som kan leses uten JavaScript. Legg til format=json (eller kall /ai/hotels.json, eller send Accept: application/json) for å få strukturert JSON.

Parametere

ParameterPåkrevdFormat og grenser
destinationjaNavn på by eller region, 2 til 80 tegn, for eksempel Dubai, Istanbul, Paris (engelsk navn fungerer best).
checkinjaDato YYYY-MM-DD: i dag eller senere (UTC), høyst 365 dager fremover.
checkoutjaDato YYYY-MM-DD, etter innsjekk; høyst 30 netter.
adultsnei, standard 2Heltall fra 1 til 6.
children_agesneiBarnas alder atskilt med komma, 0 til 17, høyst 4 barn, for eksempel 5,12.
currencynei, standard USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_priceneiPris per natt i valgt valuta, fra 0 til 100000.
limitnei, standard 10Heltall fra 1 til 20.
langnei, standard enSpråk for siden og hotellnavnene: 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 (hotellnavn på leverandørens språk en, ru, de, es, fr, tr, it, ellers på engelsk).

Eksempler

JSON-svar

status er en av ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, med en liste errors av param og message) eller provider_unavailable (503: ingen resultater og ingen priser, ingenting gjetning når leverandørens søk feiler).

data_status viser hvor resultatene kommer fra: live — søket ble nettopp kjørt; cached — et nylig søk gjenbrukes; stale — et eldre søk mens nye er begrenset; partial — leverandøren sendte fortsatt hoteller da ventetiden tok slutt (hotels_received viser hvor mange hoteller som kom; et slikt svar mellomlagres ikke, gjenta samme forespørsel senere).

Hvert element i results inneholder:

Regler for bruk

Andre innganger