>

roomesto.com · English

Căutare hoteluri pentru asistenți AI

roomesto.com răspunde la cererile de căutare a hotelurilor cu prețuri și disponibilitate live printr-o simplă cerere GET. Nu sunt necesare cont, cheie API, cookie-uri, JavaScript sau client MCP. Același motor de căutare rulează site-ul.

Adresa cererii

GET https://roomesto.com/ai/hotels returnează o pagină HTML cu rezultate care se citește fără JavaScript. Adăugați format=json (sau apelați /ai/hotels.json, sau trimiteți Accept: application/json) pentru JSON structurat.

Parametri

ParametruObligatoriuFormat și limite
destinationdaNumele orașului sau al regiunii, între 2 și 80 de caractere, de exemplu Dubai, Istanbul, Paris (numele în engleză funcționează cel mai bine).
checkindaData YYYY-MM-DD: astăzi sau mai târziu (UTC), cel mult 365 de zile înainte.
checkoutdaData YYYY-MM-DD, după sosire; cel mult 30 de nopți.
adultsnu, implicit 2Număr întreg de la 1 la 6.
children_agesnuVârstele copiilor separate prin virgule, de la 0 la 17, cel mult 4 copii, de exemplu 5,12.
currencynu, implicit USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricenuPrețul pe noapte în moneda cerută, de la 0 la 100000.
limitnu, implicit 10Număr întreg de la 1 la 20.
langnu, implicit enLimba paginii și a numelor hotelurilor: 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 (numele hotelurilor în limbile furnizorului en, ru, de, es, fr, tr, it, în rest în engleză).

Exemple

Răspuns JSON

status este unul dintre ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, cu o listă errors de param și message) sau provider_unavailable (503: fără rezultate și fără prețuri, nu ghicim nimic când căutarea la furnizor eșuează).

data_status arată de unde vin rezultatele: live — căutarea tocmai a fost executată; cached — se refolosește o căutare recentă; stale — o căutare mai veche cât timp cele noi sunt limitate; partial — furnizorul încă trimitea hoteluri când timpul de așteptare s-a încheiat (în hotels_received este numărul de hoteluri primite; un astfel de răspuns nu se memorează în cache, repetați aceeași cerere mai târziu).

Fiecare element din results conține:

Reguli de utilizare

Alte căi de acces