用文字房源系列参数查询指定日期报价
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →必填 id、checkin、checkout,日期使用未来的 YYYY-MM-DD,且退房晚于入住。可选 adults、children、infants、pets、currency 和 locale 定义比较条件。文档响应 data 类型为 StayPDPSections,metadata.bookingPrefetchData 含 cancellationPolicies 和 canInstantBook;示例中部分价格字段为 null,因此应检查实际价格分区,而不是要求单个扁平数值。此接口未纳入本次实测。它只读取观察到的房源报价,不预订,也不保证最终付款金额。
API 功能
房源系列专用日期命名 这里使用 checkin、checkout,不是住宿系列的 checkinDate、checkoutDate。
明确房源报价同行构成 按需将成人、儿童、婴幼儿和宠物人数带入房源报价比较。
报价附带取消政策背景 文档示例在指定日期房源元数据中列出了 cancellationPolicies。
防御性处理空报价字段 文档价格元数据存在 null,应解析可用分区,不凭空补成零价。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/properties-get-price API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/properties-get-price?key=<API_KEY>&id=<id>&checkin=<checkin>&checkout=<checkout>¤cy=USD&locale=en-US'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/properties-get-price?key=<API_KEY>&id=<id>&checkin=<checkin>&checkout=<checkout>¤cy=USD&locale=en-US'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 为文字搜索找到的同一房源比较周末与工作日报价,保持同行构成一致。
- 保存未来日期房源报价时,同时记录请求时间和币种代码。
- 检查选定房源在不同候选行程窗口下的取消说明是否变化。
- 导出有效价格观察前,识别缺失或为空的房源报价数据。
常见问题
properties-get-price 必须使用哪些日期参数名?
使用 checkin、checkout 和十进制 id。两个日期均必填,格式为 YYYY-MM-DD。不要向此接口发送住宿系列的 checkinDate、checkoutDate 或 listingId。
价格字段为 null 是否表示免费住宿?
不是。文档分区式响应中的价格元数据可以为空。请检查实际报价内容和状态,将缺失金额视为报价信息不可用,而不是零。此接口未纳入本次实测。