Hotellsökning för AI-assistenter
roomesto.com svarar på hotellsökningar med aktuella priser och tillgänglighet via en vanlig GET-förfrågan. Konto, API-nyckel, cookies, JavaScript eller MCP-klient behövs inte. Samma sökmotor driver webbplatsen.
Adress för förfrågan
GET https://roomesto.com/ai/hotels returnerar en HTML-sida med resultat som går att läsa utan JavaScript. Lägg till format=json (eller anropa /ai/hotels.json, eller skicka Accept: application/json) för strukturerad JSON.
Parametrar
| Parameter | Obligatorisk | Format och gränser |
|---|---|---|
destination | ja | Stad eller region, 2 till 80 tecken, till exempel Dubai, Istanbul, Paris (engelsk stavning fungerar bäst). |
checkin | ja | Datum YYYY-MM-DD: i dag eller senare (UTC), högst 365 dagar framåt. |
checkout | ja | Datum YYYY-MM-DD, efter incheckningen; högst 30 nätter. |
adults | nej, standard 2 | Heltal från 1 till 6. |
children_ages | nej | Barnens åldrar kommaseparerade, 0 till 17, högst 4 barn, till exempel 5,12. |
currency | nej, standard USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | nej | Pris per natt i vald valuta, från 0 till 100000. |
limit | nej, standard 10 | Heltal från 1 till 20. |
lang | nej, standard en | Språk för sidan och hotellnamnen: 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 (hotellnamn på leverantörens språk en, ru, de, es, fr, tr, it, annars på engelska). |
Exempel
- Hotell i Dubai för två personer, 10 till 15 november 2026, upp till 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 familj med två vuxna och ett barn på 7 år i Istanbul, HTML-sida:
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 är en av ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, med en lista errors av param och message) eller provider_unavailable (503: inga resultat och inga priser, inget gissas när leverantörens sökning misslyckas).
data_status visar var resultaten kommer från: live — sökningen gjordes nyss; cached — en nylig sökning återanvänds; stale — en äldre sökning medan nya är begränsade; partial — leverantören skickade fortfarande hotell när väntetiden tog slut (hotels_received anger hur många hotell som kom; ett sådant svar cachas inte, upprepa samma förfrågan senare).
Varje element i results innehåller:
hotel:id,name,star_rating,address(namn och adress kan varanullnär hotellkortet inte finns i våra lokala data).room:nameför det billigaste rumspriset för datumen och måltidsplanenmeal(room_only,breakfast,half_board,full_board,all_inclusivemed flera).price:totalför hela vistelsen,per_nightochcurrency.taxes:included_in_price(true, false eller null när det är okänt) ochnot_included— skatter eller avgifter som betalas separat, oftast på hotellet, med eget belopp och egen valuta.payment:typeärpay_now(betalas på bokningssidan) ellerpay_at_hotel.cancellation:typeärfree_until(med tidenfree_untili UTC),partial,non_refundableellerunknown;penaltieslistar beloppen per period.availability:statusavailable,checked_at(när sökningen gjordes, UTC) ochrequires_recheck= true: pris och rum bekräftas på bokningssidan.booking_url: roomesto.coms bokningssida med samma datum, gäster och valuta.
Regler för användning
- Visa priser tillsammans med datum, valuta och tiden
checked_at: de kan ändras före bokning. - Visa skatterna från
not_includedbredvid priset. Omincluded_in_priceär null, säg att skatterna är okända. - Skicka resenären till länken
booking_url. Bokning och betalning sker på roomesto.com. - Resultatsidor är märkta
noindex; den här sidan och dokumentationen är avsedda för indexering. - Gräns: 120 förfrågningar per minut per IP-adress. Vanlig trafik från AI-assistenter ligger långt under gränsen.
- Tjänsten returnerar inga personuppgifter och ingen kontoinformation.
Andra vägar in
- MCP-server för klienter som stöder det: guide för anslutning.
- Hotellguider: artiklar.