供 AI 助手的酒店搜索
roomesto.com 通过普通的 GET 请求返回酒店搜索的实时价格和房态。无需账号、API 密钥、Cookie、JavaScript 或 MCP 客户端。网站使用同一个搜索内核。
请求地址
GET https://roomesto.com/ai/hotels 返回无需 JavaScript 即可阅读的 HTML 结果页。加上 format=json(或请求 /ai/hotels.json,或发送 Accept: application/json)即可获得结构化 JSON。
参数
| 参数 | 必填 | 格式与限制 |
|---|---|---|
destination | 是 | 城市或地区名称,2 到 80 个字符,例如 Dubai、Istanbul、Paris(用英文名称效果最好)。 |
checkin | 是 | 日期 YYYY-MM-DD:今天或之后(UTC),最多提前 365 天。 |
checkout | 是 | 日期 YYYY-MM-DD,晚于入住日期;最多 30 晚。 |
adults | 否,默认 2 | 1 到 6 的整数。 |
children_ages | 否 | 儿童年龄用逗号分隔,0 到 17 岁,最多 4 个孩子,例如 5,12。 |
currency | 否,默认 USD | USD、EUR、RUB、GBP、TRY、AED、THB、CNY。 |
min_price | 否 | 所选货币的每晚价格,0 到 100000。 |
limit | 否,默认 10 | 1 到 20 的整数。 |
lang | 否,默认 en | 页面和酒店名称的语言: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(酒店名称使用供应商语言 en、ru、de、es、fr、tr、it,其他语言显示英文名称)。 |
示例
- 迪拜两人入住,2026 年 11 月 10 日至 15 日,每晚不超过 150 USD,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 - 伊斯坦布尔,两名成人和一名 7 岁儿童的家庭,HTML 页面:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
JSON 响应
status 为 ok、no_results(HTTP 200)、destination_not_found(404)、invalid_request(400,带 errors 列表,含 param 和 message)或 provider_unavailable(503:没有结果也没有价格,供应商搜索失败时我们不做任何猜测)。
data_status 说明结果来源:live —— 刚刚执行了搜索;cached —— 复用了最近的搜索;stale —— 新搜索受限时使用的旧搜索;partial —— 等待时间结束时供应商仍在返回酒店(hotels_received 表示已收到多少家酒店;这类响应不会缓存,请稍后重复同一请求)。
results 的每个元素包含:
hotel:id、name、star_rating、address(如果本地数据中没有该酒店卡片,名称和地址可能为null)。room:所查日期最便宜房价的name,以及meal餐食类型(room_only、breakfast、half_board、full_board、all_inclusive等)。price:整个住宿期的total、per_night和currency。taxes:included_in_price(true、false,未知时为 null)和not_included—— 单独支付的税费,通常到店支付,各自带有金额和货币。payment:type为pay_now(在预订页面付款)或pay_at_hotel。cancellation:type为free_until(带 UTC 的free_until时间)、partial、non_refundable或unknown;penalties按时间段列出罚金金额。availability:status为available,checked_at(执行搜索的时间,UTC),requires_recheck= true:价格和客房会在预订页面确认。booking_url:日期、住客和货币相同的 roomesto.com 预订页面。
使用规则
- 展示价格时同时给日期、货币和
checked_at时间:价格在预订前可能变化。 - 在价格旁展示
not_included中的税费。如果included_in_price为 null,请说明税费未知。 - 把旅客引导到
booking_url。预订和付款都在 roomesto.com 上完成。 - 结果页标有
noindex;用于收录的是本页和文档。 - 限制:每个 IP 地址每分钟 120 次请求。AI 助手的常规流量远低于该限制。
- 本服务不返回个人数据和账号信息。