Tìm khách sạn cho trợ lý AI
roomesto.com trả lời các yêu cầu tìm khách sạn bằng giá và tình trạng còn phòng trực tiếp qua một yêu cầu GET thông thường. Không cần tài khoản, khóa API, cookie, JavaScript hay ứng dụng MCP. Cùng một công cụ tìm kiếm đang chạy trên trang web.
Địa chỉ yêu cầu
GET https://roomesto.com/ai/hotels trả về trang HTML kết quả đọc được mà không cần JavaScript. Thêm format=json (hoặc gọi /ai/hotels.json, hoặc gửi Accept: application/json) để nhận JSON có cấu trúc.
Tham số
| Tham số | Bắt buộc | Định dạng và giới hạn |
|---|---|---|
destination | có | Tên thành phố hoặc khu vực, từ 2 đến 80 ký tự, ví dụ Dubai, Istanbul, Paris (tên tiếng Anh cho kết quả tốt nhất). |
checkin | có | Ngày YYYY-MM-DD: hôm nay hoặc muộn hơn (UTC), tối đa 365 ngày tới. |
checkout | có | Ngày YYYY-MM-DD, sau ngày nhận phòng; tối đa 30 đêm. |
adults | không, mặc định 2 | Số nguyên từ 1 đến 6. |
children_ages | không | Tuổi trẻ em cách nhau bằng dấu phẩy, từ 0 đến 17, tối đa 4 trẻ, ví dụ 5,12. |
currency | không, mặc định USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | không | Giá mỗi đêm theo đơn vị tiền tệ đã chọn, từ 0 đến 100000. |
limit | không, mặc định 10 | Số nguyên từ 1 đến 20. |
lang | không, mặc định en | Ngôn ngữ của trang và tên khách sạn: 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 (tên khách sạn theo ngôn ngữ của nhà cung cấp en, ru, de, es, fr, tr, it, các ngôn ngữ khác dùng tiếng Anh). |
Ví dụ
- Khách sạn ở Dubai cho hai người, từ 10 đến 15 tháng 11 năm 2026, tối đa 150 USD mỗi đêm, 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 - Gia đình hai người lớn và một trẻ 7 tuổi ở Istanbul, trang HTML:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
Phản hồi JSON
status là một trong ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, kèm danh sách errors gồm param và message) hoặc provider_unavailable (503: không kết quả và không giá, chúng tôi không đoán gì khi tìm kiếm của nhà cung cấp gặp lỗi).
data_status cho biết kết quả đến từ đâu: live — vừa thực hiện tìm kiếm; cached — dùng lại một tìm kiếm gần đây; stale — tìm kiếm cũ trong khi các tìm kiếm mới bị giới hạn; partial — nhà cung cấp vẫn đang trả khách sạn khi hết thời gian chờ (trong hotels_received là số khách sạn đã nhận; phản hồi như vậy không được lưu đệm, hãy lặp lại yêu cầu đó sau).
Mỗi phần tử của results gồm:
hotel:id,name,star_rating,address(tên và địa chỉ có thể lànullnếu thẻ khách sạn không có trong dữ liệu cục bộ của chúng tôi).room:namecủa mức giá phòng rẻ nhất cho các ngày đó và gói ănmeal(room_only,breakfast,half_board,full_board,all_inclusivevà khác).price:totalcho toàn bộ kỳ lưu trú,per_nightvàcurrency.taxes:included_in_price(true, false hoặc null khi không rõ) vànot_included— thuế hoặc phí trả riêng, thường tại khách sạn, với số tiền và đơn vị tiền tệ riêng.payment:typelàpay_now(trả trên trang đặt phòng) hoặcpay_at_hotel.cancellation:typelàfree_until(kèm thời điểmfree_untiltheo UTC),partial,non_refundablehoặcunknown;penaltiesliệt kê số tiền theo từng giai đoạn.availability:statusavailable,checked_at(khi nào tìm kiếm được chạy, UTC) vàrequires_recheck= true: giá và phòng được xác nhận trên trang đặt phòng.booking_url: trang đặt phòng của roomesto.com với cùng ngày, khách và đơn vị tiền tệ.
Quy tắc sử dụng
- Hiển thị giá kèm ngày, đơn vị tiền tệ và thời điểm
checked_at: giá có thể thay đổi trước khi đặt. - Hiển thị thuế từ
not_includedbên cạnh giá. Nếuincluded_in_pricelà null, hãy nói rằng thuế chưa rõ. - Dẫn du khách đến liên kết
booking_url. Việc đặt phòng và thanh toán diễn ra trên roomesto.com. - Trang kết quả được đánh dấu
noindex; trang này và tài liệu là để được lập chỉ mục. - Giới hạn: 120 yêu cầu mỗi phút cho một địa chỉ IP. Lưu lượng thông thường của trợ lý AI thấp hơn nhiều so với giới hạn này.
- Dịch vụ không trả về dữ liệu cá nhân hay thông tin tài khoản.
Cách truy cập khác
- Máy chủ MCP cho các ứng dụng hỗ trợ: hướng dẫn kết nối.
- Cẩm nang khách sạn: bài viết.