按目的地搜索住宿
查看 Booking 酒店与旅行数据 的全部接口 →使用已知目的地查询值（如纽约 city:20088325），并明确入住离店日期、成人数、房间数与币种。实测成功响应含 status=true、message=Success、currentPage、resultsPerPage、totalResultCount 和 data 数组；酒店行含 id、name、ufi、countryCode、住宿日期、评分、坐标、blockIds 及 priceBreakdown.grossPrice 的币种与金额。page_size=10 曾返回 20 条，应以实际分页元数据为准。目的地自动补全不可用；价格和匹配数会变化。
API 功能
已知目的地查询 使用已验证的纽约城市查询值，不要替换成酒店数字 ID。
核对返回住宿日期 保留结果前，将 checkinDate 和 checkoutDate 与请求日期比对。
查看价格与评分 结合 grossPrice 币种和金额、reviewScore 及酒店坐标解读结果。
核实实际分页大小 请求 10 条曾返回 20 条，须检查 resultsPerPage 和实际行数。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/booking/stays-search API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/booking/stays-search?key=<API_KEY>&query=city%3A20088325'
curl -X GET 'https://api.opendata-api.com/api/project/booking/stays-search?key=<API_KEY>&query=city%3A20088325'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 按旅客选择的日期和人数整理纽约住宿候选。
- 采集有限范围的城市房价快照，保留获取时间及完整住宿条件。
- 在目的地地图标注酒店前核对 ufi 与 countryCode。
- 仅将选中结果的 id 传给酒店详情，避免逐条补全所有结果。
常见问题
纽约查询实测使用了什么值？
city:20088325 返回纽约住宿，ufi=20088325。城市查询值与 hotel_id 不同；住宿目的地自动补全目前不可用。
page_size 能限制返回条数吗？
实测不能可靠保证：page_size=10 返回 20 家酒店，resultsPerPage=20、totalResultCount=549。这些是历史观察值，不是固定库存或保证生效的分页上限。
grossPrice 可以直接当作最终应付金额吗？
不能默认如此。需检查币种、住宿日期、excludedPrice 及费用字段。这只是价格快照，不会预留房间。