>

roomesto.com · English

Пошук готелів для ШІ-асистентів

roomesto.com відповідає на запити про пошук готелів актуальними цінами та наявністю через звичайний GET-запит. Обліковий запис, ключ API, файли cookie, JavaScript і MCP-клієнт не потрібні. Той самий пошуковий рушій працює на сайті.

Адреса запиту

GET https://roomesto.com/ai/hotels повертає HTML-сторінку з результатами, яку можна читати без JavaScript. Додайте format=json (або зверніться до /ai/hotels.json, або надішліть Accept: application/json), щоб отримати структурований JSON.

Параметри

ПараметрОбов'язковийФормат і обмеження
destinationтакНазва міста або регіону, від 2 до 80 символів, наприклад Dubai, Istanbul, Paris (найкраще англійською).
checkinтакДата YYYY-MM-DD: сьогодні або пізніше (UTC), не більше ніж 365 днів наперед.
checkoutтакДата YYYY-MM-DD, після дати заїзду; не більше 30 ночей.
adultsні, за замовчуванням 2Ціле число від 1 до 6.
children_agesніВік дітей через кому, від 0 до 17, не більше 4 дітей, наприклад 5,12.
currencyні, за замовчуванням USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_priceніЦіна за ніч у вибраній валюті, від 0 до 100000.
limitні, за замовчуванням 10Ціле число від 1 до 20.
langні, за замовчуванням enМова сторінки та назв готелів: 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 (назви готелів мовами постачальника en, ru, de, es, fr, tr, it, в інших випадках англійською).

Приклади

Відповідь JSON

status — одне зі значень ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, зі списком errors із param і message) або provider_unavailable (503: без результатів і без цін, ми нічого не вгадуємо, коли пошук у постачальника не працює).

data_status показує, звідки результати: live — пошук виконано щойно; cached — використано недавній пошук; stale — старіший пошук, поки нові обмежені; partial — постачальник ще надсилав готелі, коли вийшов час очікування (у hotels_received — скільки готелів отримано; така відповідь не кешується, повторіть той самий запит пізніше).

Кожен елемент results містить:

Правила використання

Інші способи доступу