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
| Parametru | Obligatoriu | Format și limite |
|---|---|---|
destination | da | Numele orașului sau al regiunii, între 2 și 80 de caractere, de exemplu Dubai, Istanbul, Paris (numele în engleză funcționează cel mai bine). |
checkin | da | Data YYYY-MM-DD: astăzi sau mai târziu (UTC), cel mult 365 de zile înainte. |
checkout | da | Data YYYY-MM-DD, după sosire; cel mult 30 de nopți. |
adults | nu, implicit 2 | Număr întreg de la 1 la 6. |
children_ages | nu | Vârstele copiilor separate prin virgule, de la 0 la 17, cel mult 4 copii, de exemplu 5,12. |
currency | nu, implicit USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | nu | Prețul pe noapte în moneda cerută, de la 0 la 100000. |
limit | nu, implicit 10 | Număr întreg de la 1 la 20. |
lang | nu, implicit en | Limba 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
- Hoteluri în Dubai pentru două persoane, 10–15 noiembrie 2026, până la 150 USD pe noapte, 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 - O familie cu doi adulți și un copil de 7 ani în Istanbul, pagină HTML:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
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:
hotel:id,name,star_rating,address(numele și adresa pot finulldacă fișa hotelului nu este în datele noastre locale).room:nameal celei mai ieftine tarife de cameră pentru date și planul de masămeal(room_only,breakfast,half_board,full_board,all_inclusiveși altele).price:totalpentru întreaga ședere,per_nightșicurrency.taxes:included_in_price(true, false sau null când nu se cunoaște) șinot_included— taxe sau comisioane plătite separat, de obicei la hotel, cu suma și moneda lor.payment:typeestepay_now(plata pe pagina de rezervare) saupay_at_hotel.cancellation:typeestefree_until(cu orafree_untilîn UTC),partial,non_refundablesauunknown;penaltieslistează sumele pe perioade.availability:statusavailable,checked_at(când a rulat căutarea, UTC) șirequires_recheck= true: prețul și camera sunt confirmate pe pagina de rezervare.booking_url: pagina de rezervare roomesto.com cu aceleași date, oaspeți și monedă.
Reguli de utilizare
- Afișați prețurile împreună cu data, moneda și ora
checked_at: se pot schimba înainte de rezervare. - Afișați taxele din
not_includedlângă preț. Dacăincluded_in_priceeste null, spuneți că taxele sunt necunoscute. - Trimiteți călătorul la linkul
booking_url. Rezervarea și plata au loc pe roomesto.com. - Paginile de rezultate sunt marcate
noindex; această pagină și documentația sunt destinate indexării. - Limită: 120 de cereri pe minut per adresă IP. Traficul obișnuit al asistenților AI este mult sub această limită.
- Serviciul nu returnează date personale sau informații despre cont.
Alte căi de acces
- Server MCP pentru clienții care îl acceptă: ghid de conectare.
- Ghiduri de hoteluri: articole.