查询酒店详情与住宿价格

查看 Booking 酒店与旅行数据 的全部接口 →

使用数字 hotel_id，可附住宿日期、成人数、儿童年龄、房间数、币种与语言。酒店 180769 曾返回 Hyatt Grand Central New York，status=true、message=Success；数据含酒店身份、城市国家、链接地址、arrival_date、departure_date、currency_code、rooms、facilities_block.facilities、block 和 composite_price_breakdown。房型区块含 block_id、入住人数、价格及取消与预付款政策。未传日期时，文档默认当天至四天后；可复现比价需填写两端日期。不存在的 ID 曾返回 HTTP 200，但 status=false、status_code=400、message=NO DATA!、data=null；这不能说明其他 NO DATA 的统一原因。

API 功能

已核验酒店身份 180769 曾对应 Hyatt Grand Central New York 及其房源链接。
保留房型上下文 将 block_id 与酒店、日期、入住人数和币种一起保存，供后续只读查询。
区分每晚与整段住宿价格 实测 composite_price_breakdown 区分 gross_amount_per_night、gross_amount 和未含费用。
处理 HTTP 200 下业务失败 先识别 status=false、status_code=400，再提取详情字段。

在线 API 演示

GET /api/project/booking/get-hotel-details

调用成本暂不可用，未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/booking/get-hotel-details?key=<API_KEY>&hotel_id=180769'
📢
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
联系我们

使用场景

常见问题

不传 checkin_date 和 checkout_date 时查询哪几天？

文档默认当天入住、四天后离店。未传日期的探测曾返回 2026-10-18 至 2026-10-22，这是当时的日期，不是永久默认值。房价研究请明确填写两端日期。

为什么 HTTP 200 仍可能返回 NO DATA？

传输成功与业务成功不同。不存在的酒店曾返回 message=NO DATA!、status=false、status_code=400、data=null；该响应不能说明所有 NO DATA 的统一根因。

hotel_id 应填写哪种 ID？

使用数字酒店 ID，例如已验证的 180769 或酒店搜索结果的 id。纽约城市 UFI 20088325 和房源流程的 detail_id 都不是同一种标识。

返回房价是否代表已预留房间？

不是，这是只读详情查询。需检查价格明细、附加费、人数、日期和房型政策；另行预订前，价格与房态都可能变化。

相关接口

相关指南

查看订阅方案 →