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
| Parameter | Påkrevd | Format og grenser |
|---|---|---|
destination | ja | Navn på by eller region, 2 til 80 tegn, for eksempel Dubai, Istanbul, Paris (engelsk navn fungerer best). |
checkin | ja | Dato YYYY-MM-DD: i dag eller senere (UTC), høyst 365 dager fremover. |
checkout | ja | Dato YYYY-MM-DD, etter innsjekk; høyst 30 netter. |
adults | nei, standard 2 | Heltall fra 1 til 6. |
children_ages | nei | Barnas alder atskilt med komma, 0 til 17, høyst 4 barn, for eksempel 5,12. |
currency | nei, standard USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | nei | Pris per natt i valgt valuta, fra 0 til 100000. |
limit | nei, standard 10 | Heltall fra 1 til 20. |
lang | nei, standard en | Språ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
- Hoteller i Dubai for to personer, 10. til 15. november 2026, opptil 150 USD per natt, 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 - En familie med to voksne og et barn på 7 år i Istanbul, HTML-side:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
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:
hotel:id,name,star_rating,address(navn og adresse kan værenullnår hotellkortet ikke finnes i våre lokale data).room:namepå den billigste romprisen for datoene og måltidsplanenmeal(room_only,breakfast,half_board,full_board,all_inclusivemed flere).price:totalfor hele oppholdet,per_nightogcurrency.taxes:included_in_price(true, false eller null når ukjent) ognot_included— skatter eller avgifter som betales separat, vanligvis på hotellet, med eget beløp og egen valuta.payment:typeerpay_now(betales på bestillingssiden) ellerpay_at_hotel.cancellation:typeerfree_until(med tidspunktetfree_untili UTC),partial,non_refundableellerunknown;penaltieslister beløpene per periode.availability:statusavailable,checked_at(når søket ble kjørt, UTC) ogrequires_recheck= true: pris og rom bekreftes på bestillingssiden.booking_url: roomesto.com sin bestillingsside med samme datoer, gjester og valuta.
Regler for bruk
- Vis priser sammen med dato, valuta og tidspunktet
checked_at: de kan endre seg før bestilling. - Vis skattene fra
not_includedved siden av prisen. Erincluded_in_pricenull, si at skattene er ukjente. - Led den reisende til lenken
booking_url. Bestilling og betaling skjer på roomesto.com. - Resultatsider er merket
noindex; denne siden og dokumentasjonen er ment for indeksering. - Grense: 120 forespørsler per minutt per IP-adresse. Vanlig trafikk fra AI-assistenter ligger langt under denne grensen.
- Tjenesten returnerer ingen personopplysninger eller kontoinformasjon.
Andre innganger
- MCP-server for klienter som støtter det: veiledning for tilkobling.
- Hotellguider: artikler.