>

roomesto.com · English

Pencarian hotel untuk asisten AI

roomesto.com menjawab permintaan pencarian hotel dengan harga dan ketersediaan langsung melalui permintaan GET biasa. Akun, kunci API, cookie, JavaScript, atau klien MCP tidak diperlukan. Mesin pencari yang sama menjalankan situs ini.

Alamat permintaan

GET https://roomesto.com/ai/hotels mengembalikan halaman HTML hasil yang dapat dibaca tanpa JavaScript. Tambahkan format=json (atau panggil /ai/hotels.json, atau kirim Accept: application/json) untuk mendapatkan JSON terstruktur.

Parameter

ParameterWajibFormat dan batasan
destinationyaNama kota atau wilayah, 2 sampai 80 karakter, misalnya Dubai, Istanbul, Paris (nama dalam bahasa Inggris paling baik).
checkinyaTanggal YYYY-MM-DD: hari ini atau setelahnya (UTC), paling lambat 365 hari ke depan.
checkoutyaTanggal YYYY-MM-DD, setelah tanggal kedatangan; paling lama 30 malam.
adultstidak, bawaan 2Bilangan bulat 1 sampai 6.
children_agestidakUsia anak dipisahkan koma, 0 sampai 17, paling banyak 4 anak, misalnya 5,12.
currencytidak, bawaan USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricetidakHarga per malam dalam mata uang yang diminta, 0 sampai 100000.
limittidak, bawaan 10Bilangan bulat 1 sampai 20.
langtidak, bawaan enBahasa halaman dan nama hotel: 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 (nama hotel dalam bahasa pemasok en, ru, de, es, fr, tr, it, selain itu bahasa Inggris).

Contoh

Respons JSON

status adalah salah satu dari ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, dengan daftar errors berisi param dan message) atau provider_unavailable (503: tanpa hasil dan tanpa harga, tidak ada yang ditebak saat pencarian pemasok gagal).

data_status menunjukkan asal hasil: live — pencarian baru saja dijalankan; cached — pencarian terbaru digunakan ulang; stale — pencarian lama saat pencarian baru dibatasi; partial — pemasok masih mengirim hotel saat waktu tunggu habis (di hotels_received ada jumlah hotel yang diterima; respons seperti ini tidak disimpan di cache, ulangi permintaan yang sama nanti).

Setiap elemen results berisi:

Aturan penggunaan

Cara akses lain