>

roomesto.com · English

供 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否,默认 21 到 6 的整数。
children_ages否儿童年龄用逗号分隔,0 到 17 岁,最多 4 个孩子,例如 5,12。
currency否,默认 USDUSD、EUR、RUB、GBP、TRY、AED、THB、CNY。
min_price否所选货币的每晚价格,0 到 100000。
limit否,默认 101 到 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,其他语言显示英文名称)。

示例

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 的每个元素包含:

使用规则

其他接入方式