按目的地、入住退房日期查询酒店
查看 Skyscanner 天巡机票与酒店查询 的全部接口 →先用酒店目的地搜索获取 entityId，再传入未来的 checkIn/checkOut，格式为 YYYY-MM-DD，且退房必须晚于入住。可选 adults、rooms、currency 与 market 描述入住条件。已测试的巴黎响应包含 destinationName、total 和 hotels；酒店记录有 hotelId、name、stars、数值 rating、reviewCount、price.amount/currency、图片 URL 字符串数组 images、amenities、url、coordinates.lat/lng，以及表示街区的文本 distance。不要把 rating 当嵌套评分对象、images 当带说明的对象数组，也不要将 distance 换算为米。返回列表可能只是 total 的一部分，本接口未提供分页参数。单凭这些字段无法确定价格按晚还是按整段入住计费，也无法确认税费和房型条款；比较最终费用或引导预订前应另行核实。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/skyscanner/hotels-search-hotels API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/hotels-search-hotels?key=<API_KEY>&entityId=<entityId>&checkIn=<checkIn>&checkOut=<checkOut>&adults=2&rooms=1¤cy=USD&market=US'
查询结果
使用场景
- 指定入住期酒店卡片：展示实际返回的名称、星级、数值评分、评价数与图片链接。
- 已获取候选的设施筛选：依据当前列表的设施与评分筛选，不宣称已过滤整个目的地酒店库存。
- 旅行住宿比较表导出：保存候选酒店的经纬度和街区描述，供行程规划进一步核对。
- 保留入住条件的预订入口：将入住退房日、成人数和房间数与返回链接一同展示，说明比较的住宿安排。
常见问题
如何按目的地、入住退房日期、人数和房间数搜索酒店？
先从酒店目的地搜索中选定目标区域并取得 entityId，再传入未来的 checkIn 与晚于入住日的 checkOut，可选设置 adults、rooms、currency 和 market。目的地 ID 不是 hotelId；后续单个酒店查询使用搜索返回的 hotelId。
酒店评分、图片、距离和价格字段应该怎么处理？
已测试记录的 rating 为数值，images 为 URL 字符串数组，distance 为街区描述而非米数，坐标在 coordinates.lat/lng。price.amount 的每晚或整段入住口径、税费和条款尚未确定，必须核实后再比较最终费用；列表也可能只是 total 的一部分，当前无分页参数。