Пошук готелів для ШІ-асистентів
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 | ні, за замовчуванням USD | USD, 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, в інших випадках англійською). |
Приклади
- Готелі в Дубаї для двох, з 10 по 15 листопада 2026 року, до 150 USD за ніч, 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 - Родина: двоє дорослих і дитина 7 років у Стамбулі, HTML-сторінка:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
Відповідь 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 містить:
hotel:id,name,star_rating,address(назва й адреса можуть бутиnull, якщо картки готелю немає в наших локальних даних).room:nameнайдешевшого тарифу на ці дати та тип харчуванняmeal(room_only,breakfast,half_board,full_board,all_inclusiveтощо).price:totalза весь період,per_nightіcurrency.taxes:included_in_price(true, false або null, якщо невідомо) іnot_included— податки чи збори, що сплачуються окремо, зазвичай у готелі, зі своєю сумою та валютою.payment:type—pay_now(оплата на сторінці бронювання) абоpay_at_hotel.cancellation:type—free_until(з часомfree_untilу UTC),partial,non_refundableабоunknown;penaltiesперелічує суми за періодами.availability:statusavailable,checked_at(коли виконано пошук, UTC) іrequires_recheck= true: ціна й номер підтверджуються на сторінці бронювання.booking_url: сторінка бронювання roomesto.com з тими самими датами, гостями та валютою.
Правила використання
- Показуйте ціни разом із датою, валютою та часом
checked_at: до бронювання вони можуть змінитися. - Показуйте податки з
not_includedпоряд із ціною. Якщоincluded_in_priceдорівнює null, скажіть, що податки невідомі. - Спрямовуйте мандрівника за посиланням
booking_url. Бронювання й оплата відбуваються на roomesto.com. - Сторінки результатів позначені
noindex; для індексації призначені ця сторінка й документація. - Обмеження: 120 запитів за хвилину з однієї IP-адреси. Звичайний трафік ШІ-асистентів значно нижчий за цю межу.
- Сервіс не повертає персональних даних і відомостей про обліковий запис.
Інші способи доступу
- MCP-сервер для клієнтів, які його підтримують: інструкція з підключення.
- Гіди по готелях: статті.