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
| Parameter | Wajib | Format dan batasan |
|---|---|---|
destination | ya | Nama kota atau wilayah, 2 sampai 80 karakter, misalnya Dubai, Istanbul, Paris (nama dalam bahasa Inggris paling baik). |
checkin | ya | Tanggal YYYY-MM-DD: hari ini atau setelahnya (UTC), paling lambat 365 hari ke depan. |
checkout | ya | Tanggal YYYY-MM-DD, setelah tanggal kedatangan; paling lama 30 malam. |
adults | tidak, bawaan 2 | Bilangan bulat 1 sampai 6. |
children_ages | tidak | Usia anak dipisahkan koma, 0 sampai 17, paling banyak 4 anak, misalnya 5,12. |
currency | tidak, bawaan USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | tidak | Harga per malam dalam mata uang yang diminta, 0 sampai 100000. |
limit | tidak, bawaan 10 | Bilangan bulat 1 sampai 20. |
lang | tidak, bawaan en | Bahasa 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
- Hotel di Dubai untuk dua orang, 10 sampai 15 November 2026, maksimal 150 USD per malam, 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 - Keluarga dua orang dewasa dan satu anak berusia 7 tahun di Istanbul, halaman HTML:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
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:
hotel:id,name,star_rating,address(nama dan alamat bisanulljika kartu hotel tidak ada di data lokal kami).room:nametarif kamar termurah untuk tanggal tersebut dan paket makananmeal(room_only,breakfast,half_board,full_board,all_inclusive, dan lainnya).price:totaluntuk seluruh masa inap,per_night, dancurrency.taxes:included_in_price(true, false, atau null bila tidak diketahui) dannot_included— pajak atau biaya yang dibayar terpisah, biasanya di hotel, dengan jumlah dan mata uangnya sendiri.payment:typeadalahpay_now(dibayar di halaman pemesanan) ataupay_at_hotel.cancellation:typeadalahfree_until(dengan waktufree_untildalam UTC),partial,non_refundable, atauunknown;penaltiesmencantumkan jumlah per periode.availability:statusavailable,checked_at(kapan pencarian dijalankan, UTC), danrequires_recheck= true: harga dan kamar dikonfirmasi di halaman pemesanan.booking_url: halaman pemesanan roomesto.com dengan tanggal, tamu, dan mata uang yang sama.
Aturan penggunaan
- Tampilkan harga bersama tanggal, mata uang, dan waktu
checked_at: harga dapat berubah sebelum pemesanan. - Tampilkan pajak dari
not_includeddi samping harga. Jikaincluded_in_pricebernilai null, katakan bahwa pajak tidak diketahui. - Arahkan pelancong ke tautan
booking_url. Pemesanan dan pembayaran terjadi di roomesto.com. - Halaman hasil ditandai
noindex; halaman ini dan dokumentasi ditujukan untuk pengindeksan. - Batas: 120 permintaan per menit per alamat IP. Lalu lintas asisten AI biasa jauh di bawah batas ini.
- Layanan tidak mengembalikan data pribadi maupun informasi akun.
Cara akses lain
- Server MCP untuk klien yang mendukungnya: panduan koneksi.
- Panduan hotel: artikel.