查询指定日期的爱彼迎住宿价格明细
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →必须提供 listingId、checkinDate、checkoutDate,日期用未来的 YYYY-MM-DD,退房晚于入住;同行人数与 currencyCode 应与待比较搜索一致。实测返回 status:true、message:Successful,以及类型为 StayPDPSections 的 data,三个 sectionContainer 分区包含预订价格和取消政策。structuredDisplayPrice 含取整后的住宿醒目价格,explanationData 的价格项则有更精确的 priceString。不要将取整每晚价直接相乘,也不要把醒目价格当作保证的最终付款总额。displayTotalPrice 的文档含义是含费用、税前总价;此 GET 只查价,不预订。
API 功能
明确日期绑定单套住宿报价 将价格请求限定到一套房源和明确的入住退房窗口。
醒目价格与精确说明对照 对比主展示行的取整价格与说明项中更精确的金额。
以价格分区理解报价 实测按日期响应使用价格与取消政策分区,不是单个数值字段。
明确税前总价展示口径 displayTotalPrice 文档说明含费用但未含税,不构成最终扣款保证。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/stays-price-detail API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-price-detail?key=<API_KEY>&listingId=1173047051903832695&checkinDate=<checkinDate>&checkoutDate=<checkoutDate>&adults=2¤cyCode=USD&languageCode=en-US'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-price-detail?key=<API_KEY>&listingId=1173047051903832695&checkinDate=<checkinDate>&checkoutDate=<checkoutDate>&adults=2¤cyCode=USD&languageCode=en-US'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 保持人数和币种一致,对比同一住宿在不同未来行程窗口的价格。
- 在比较界面同时说明住宿取整展示价及更精确的报价说明金额。
- 为可比房源研究保存带查询时间的指定日期报价,而不标记为历史成交。
- 在打开原始房源前,结合返回的取消条款查看本次日期报价。
常见问题
为什么醒目展示价和说明金额会略有差异?
实测五晚示例中,同一住宿的醒目价格取整到货币整数,说明项则保留更精确金额。请读取 structuredDisplayPrice.explanationData,不要用取整每晚展示价直接相乘,也不要把舍入差异视为报价冲突。
displayTotalPrice 是否含税,是否会创建预订?
文档含义是含费用、税前总价。这是只读价格查询,不锁定房源、不向旅客扣款,也不保证后续预订总额。