Wyszukiwarka hoteli dla asystentów AI
roomesto.com odpowiada na zapytania o hotele aktualnymi cenami i dostępnością za pomocą zwykłego żądania GET. Konto, klucz API, pliki cookie, JavaScript ani klient MCP nie są potrzebne. Ten sam silnik wyszukiwania obsługuje stronę.
Adres zapytania
GET https://roomesto.com/ai/hotels zwraca stronę HTML z wynikami, którą można czytać bez JavaScriptu. Dodaj format=json (albo wywołaj /ai/hotels.json, albo wyślij Accept: application/json), aby otrzymać ustrukturyzowany JSON.
Parametry
| Parametr | Wymagany | Format i ograniczenia |
|---|---|---|
destination | tak | Nazwa miasta lub regionu, od 2 do 80 znaków, na przykład Dubai, Istanbul, Paris (najlepiej po angielsku). |
checkin | tak | Data YYYY-MM-DD: dziś lub później (UTC), najwyżej 365 dni do przodu. |
checkout | tak | Data YYYY-MM-DD, po dacie przyjazdu; najwyżej 30 nocy. |
adults | nie, domyślnie 2 | Liczba całkowita od 1 do 6. |
children_ages | nie | Wiek dzieci oddzielony przecinkami, od 0 do 17, najwyżej 4 dzieci, na przykład 5,12. |
currency | nie, domyślnie USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | nie | Cena za noc w wybranej walucie, od 0 do 100000. |
limit | nie, domyślnie 10 | Liczba całkowita od 1 do 20. |
lang | nie, domyślnie en | Język strony i nazw hoteli: 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 (nazwy hoteli w językach dostawcy en, ru, de, es, fr, tr, it, w pozostałych po angielsku). |
Przykłady
- Hotele w Dubaju dla dwóch osób, od 10 do 15 listopada 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 - Rodzina: dwoje dorosłych i 7-letnie dziecko w Stambule, strona HTML:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
Odpowiedź JSON
status przyjmuje jedną z wartości: ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, z listą errors zawierającą param i message) lub provider_unavailable (503: brak wyników i brak cen, niczego nie zgadujemy, gdy wyszukiwanie u dostawcy nie działa).
data_status pokazuje, skąd pochodzą wyniki: live — wyszukiwanie właśnie wykonano; cached — użyto ponownie niedawnego wyszukiwania; stale — starsze wyszukiwanie, gdy nowe są ograniczone; partial — dostawca wciąż zwracał hotele, gdy skończył się czas oczekiwania (w hotels_received jest liczba otrzymanych hoteli; taka odpowiedź nie jest buforowana, powtórz to samo zapytanie później).
Każdy element results zawiera:
hotel:id,name,star_rating,address(nazwa i adres mogą byćnull, jeśli karty hotelu nie ma w naszych danych lokalnych).room:namenajtańszej stawki za pokój na te daty oraz plan wyżywieniameal(room_only,breakfast,half_board,full_board,all_inclusivei inne).price:totalza cały pobyt,per_nighticurrency.taxes:included_in_price(true, false lub null, gdy nieznane) oraznot_included— podatki lub opłaty płatne osobno, zwykle w hotelu, z własną kwotą i walutą.payment:typetopay_now(płatność na stronie rezerwacji) lubpay_at_hotel.cancellation:typetofree_until(z czasemfree_untilw UTC),partial,non_refundablelubunknown;penaltieswymienia kwoty według okresów.availability:statusavailable,checked_at(kiedy wykonano wyszukiwanie, UTC) irequires_recheck= true: cena i pokój są potwierdzane na stronie rezerwacji.booking_url: strona rezerwacji roomesto.com z tymi samymi datami, gośćmi i walutą.
Zasady korzystania
- Pokazuj ceny razem z datą, walutą i godziną
checked_at: mogą się zmienić przed rezerwacją. - Pokazuj podatki z
not_includedobok ceny. Jeśliincluded_in_pricema wartość null, powiedz, że podatki są nieznane. - Kieruj podróżnego do linku
booking_url. Rezerwacja i płatność odbywają się w roomesto.com. - Strony wyników są oznaczone
noindex; do indeksowania przeznaczone są ta strona i dokumentacja. - Limit: 120 żądań na minutę z jednego adresu IP. Zwykły ruch asystentów AI jest znacznie poniżej tego limitu.
- Usługa nie zwraca danych osobowych ani informacji o koncie.
Inne sposoby dostępu
- Serwer MCP dla klientów, które go obsługują: instrukcja podłączenia.
- Przewodniki po hotelach: artykuły.