>

roomesto.com · English

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

ParametrPovinnýFormát a limity
destinationanoNázev města nebo regionu, 2 až 80 znaků, například Dubai, Istanbul, Paris (nejlépe anglicky).
checkinanoDatum YYYY-MM-DD: dnes nebo později (UTC), nejvýše 365 dní dopředu.
checkoutanoDatum YYYY-MM-DD, po příjezdu; nejvýše 30 nocí.
adultsne, výchozí 2Celé číslo od 1 do 6.
children_agesneVěk dětí oddělený čárkami, 0 až 17, nejvýše 4 děti, například 5,12.
currencyne, výchozí USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_priceneCena za noc ve zvolené měně, od 0 do 100000.
limitne, výchozí 10Celé číslo od 1 do 20.
langne, výchozí enJazyk 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

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:

Pravidla používání

Další způsoby přístupu