>

roomesto.com · English

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
destinationcó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).
checkincóNgày YYYY-MM-DD: hôm nay hoặc muộn hơn (UTC), tối đa 365 ngày tới.
checkoutcóNgày YYYY-MM-DD, sau ngày nhận phòng; tối đa 30 đêm.
adultskhông, mặc định 2Số nguyên từ 1 đến 6.
children_ageskhôngTuổ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.
currencykhông, mặc định USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricekhôngGiá mỗi đêm theo đơn vị tiền tệ đã chọn, từ 0 đến 100000.
limitkhông, mặc định 10Số nguyên từ 1 đến 20.
langkhông, mặc định enNgô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ụ

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:

Quy tắc sử dụng

Cách truy cập khác