>

roomesto.com · English

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

ParametrWymaganyFormat i ograniczenia
destinationtakNazwa miasta lub regionu, od 2 do 80 znaków, na przykład Dubai, Istanbul, Paris (najlepiej po angielsku).
checkintakData YYYY-MM-DD: dziś lub później (UTC), najwyżej 365 dni do przodu.
checkouttakData YYYY-MM-DD, po dacie przyjazdu; najwyżej 30 nocy.
adultsnie, domyślnie 2Liczba całkowita od 1 do 6.
children_agesnieWiek dzieci oddzielony przecinkami, od 0 do 17, najwyżej 4 dzieci, na przykład 5,12.
currencynie, domyślnie USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricenieCena za noc w wybranej walucie, od 0 do 100000.
limitnie, domyślnie 10Liczba całkowita od 1 do 20.
langnie, domyślnie enJę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

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:

Zasady korzystania

Inne sposoby dostępu