Hotelsøgning til AI-assistenter
roomesto.com svarer på hotelforespørgsler med aktuelle priser og ledighed via en almindelig GET-anmodning. Konto, API-nøgle, cookies, JavaScript eller MCP-klient er ikke nødvendig. Den samme søgemaskine driver webstedet.
Adresse for anmodningen
GET https://roomesto.com/ai/hotels returnerer en HTML-resultatside, der kan læses uden JavaScript. Tilføj format=json (eller kald /ai/hotels.json, eller send Accept: application/json) for at få struktureret JSON.
Parametre
| Parameter | Påkrævet | Format og grænser |
|---|---|---|
destination | ja | Navn på by eller region, 2 til 80 tegn, for eksempel Dubai, Istanbul, Paris (engelsk navn virker bedst). |
checkin | ja | Dato YYYY-MM-DD: i dag eller senere (UTC), højst 365 dage frem. |
checkout | ja | Dato YYYY-MM-DD, efter indtjekning; højst 30 nætter. |
adults | nej, standard 2 | Heltal fra 1 til 6. |
children_ages | nej | Børnenes alder adskilt med kommaer, 0 til 17, højst 4 børn, for eksempel 5,12. |
currency | nej, standard USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | nej | Pris pr. nat i den valgte valuta, fra 0 til 100000. |
limit | nej, standard 10 | Heltal fra 1 til 20. |
lang | nej, standard en | Sprog for siden og hotelnavnene: 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 (hotelnavne på leverandørens sprog en, ru, de, es, fr, tr, it, ellers på engelsk). |
Eksempler
- Hoteller i Dubai til to personer, 10. til 15. november 2026, op til 150 USD pr. nat, 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 af ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, med en liste errors af param og message) eller provider_unavailable (503: ingen resultater og ingen priser, der gættes ikke på noget, når leverandørens søgning fejler).
data_status viser, hvor resultaterne kommer fra: live — søgningen blev netop kørt; cached — en nylig søgning genbruges; stale — en ældre søgning, mens nye er begrænsede; partial — leverandøren sendte stadig hoteller, da ventetiden udløb (hotels_received angiver, hvor mange hoteller der kom; et sådant svar caches ikke, gentag den samme anmodning senere).
Hvert element i results indeholder:
hotel:id,name,star_rating,address(navn og adresse kan værenull, når hotelkortet ikke findes i vores lokale data).room:namepå den billigste værelsespris for datoerne og måltidsplanenmeal(room_only,breakfast,half_board,full_board,all_inclusivemed flere).price:totalfor hele opholdet,per_nightogcurrency.taxes:included_in_price(true, false eller null når ukendt) ognot_included— skatter eller gebyrer, der betales separat, oftest på hotellet, med eget beløb og egen valuta.payment:typeerpay_now(betales på bookingsiden) ellerpay_at_hotel.cancellation:typeerfree_until(med tidspunktetfree_untili UTC),partial,non_refundableellerunknown;penaltiesviser beløbene pr. periode.availability:statusavailable,checked_at(hvornår søgningen blev kørt, UTC) ogrequires_recheck= true: pris og værelse bekræftes på bookingsiden.booking_url: roomesto.com's bookingside med de samme datoer, gæster og valuta.
Regler for brug
- Vis priser sammen med dato, valuta og tidspunktet
checked_at: de kan ændre sig før booking. - Vis skatterne fra
not_includedved siden af prisen. Erincluded_in_pricenull, så sig, at skatterne er ukendte. - Send den rejsende til linket
booking_url. Booking og betaling sker på roomesto.com. - Resultatsider er markeret med
noindex; denne side og dokumentationen er beregnet til indeksering. - Grænse: 120 anmodninger pr. minut pr. IP-adresse. Almindelig trafik fra AI-assistenter ligger langt under denne grænse.
- Tjenesten returnerer ingen personoplysninger og ingen kontooplysninger.
Andre adgange
- MCP-server til klienter, der understøtter det: vejledning i tilslutning.
- Hotelguider: artikler.