Vyhledávání hotelů pro AI asistenty
roomesto.com odpovídá na dotazy na hotely aktuálními cenami a dostupností přes běžný požadavek GET. Účet, API klíč, cookies, JavaScript ani MCP klient nejsou potřeba. Stejný vyhledávač pohání web.
Adresa požadavku
GET https://roomesto.com/ai/hotels vrací HTML stránku s výsledky, kterou lze číst bez JavaScriptu. Přidejte format=json (nebo zavolejte /ai/hotels.json, nebo pošlete Accept: application/json) a získáte strukturovaný JSON.
Parametry
| Parametr | Povinný | Formát a limity |
|---|---|---|
destination | ano | Název města nebo regionu, 2 až 80 znaků, například Dubai, Istanbul, Paris (nejlépe anglicky). |
checkin | ano | Datum YYYY-MM-DD: dnes nebo později (UTC), nejvýše 365 dní dopředu. |
checkout | ano | Datum YYYY-MM-DD, po příjezdu; nejvýše 30 nocí. |
adults | ne, výchozí 2 | Celé číslo od 1 do 6. |
children_ages | ne | Věk dětí oddělený čárkami, 0 až 17, nejvýše 4 děti, například 5,12. |
currency | ne, výchozí USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | ne | Cena za noc ve zvolené měně, od 0 do 100000. |
limit | ne, výchozí 10 | Celé číslo od 1 do 20. |
lang | ne, výchozí en | Jazyk stránky a názvů hotelů: 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 (názvy hotelů v jazycích dodavatele en, ru, de, es, fr, tr, it, jinak anglicky). |
Příklady
- Hotely v Dubaji pro dva, 10. až 15. listopadu 2026, do 150 USD za noc, 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 - Rodina se dvěma dospělými a sedmiletým dítětem v Istanbulu, HTML stránka:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
Odpověď JSON
status je jedna z hodnot ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, se seznamem errors obsahujícím param a message) nebo provider_unavailable (503: žádné výsledky a žádné ceny, nic nehádáme, když vyhledávání u dodavatele selže).
data_status ukazuje, odkud výsledky pocházejí: live — vyhledávání právě proběhlo; cached — použito nedávné vyhledávání; stale — starší vyhledávání, dokud jsou nová omezená; partial — dodavatel stále vracel hotely, když vypršel čas čekání (v hotels_received je počet přijatých hotelů; taková odpověď se neukládá do mezipaměti, zopakujte stejný požadavek později).
Každý prvek results obsahuje:
hotel:id,name,star_rating,address(název a adresa mohou býtnull, pokud karta hotelu není v našich místních datech).room:namenejlevnější sazby za pokoj na dané termíny a stravovací plánmeal(room_only,breakfast,half_board,full_board,all_inclusivea další).price:totalza celý pobyt,per_nightacurrency.taxes:included_in_price(true, false nebo null, když není známo) anot_included— daně nebo poplatky placené zvlášť, obvykle v hotelu, s vlastní částkou a měnou.payment:typejepay_now(platba na rezervační stránce) nebopay_at_hotel.cancellation:typejefree_until(s časemfree_untilv UTC),partial,non_refundablenebounknown;penaltiesuvádí částky podle období.availability:statusavailable,checked_at(kdy vyhledávání proběhlo, UTC) arequires_recheck= true: cena a pokoj se potvrzují na rezervační stránce.booking_url: rezervační stránka roomesto.com se stejnými termíny, hosty a měnou.
Pravidla používání
- Zobrazujte ceny spolu s datem, měnou a časem
checked_at: do rezervace se mohou změnit. - Zobrazujte daně z
not_includedvedle ceny. Pokud jeincluded_in_pricenull, řekněte, že daně nejsou známé. - Veďte cestujícího na odkaz
booking_url. Rezervace a platba probíhají na roomesto.com. - Stránky výsledků jsou označeny
noindex; k indexaci je určena tato stránka a dokumentace. - Limit: 120 požadavků za minutu z jedné IP adresy. Běžný provoz AI asistentů je hluboko pod tímto limitem.
- Služba nevrací osobní údaje ani informace o účtu.
Další způsoby přístupu
- Server MCP pro klienty, kteří ho podporují: návod k připojení.
- Průvodce hotely: články.