读取爱彼迎结算式报价与费用分项
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →使用 listingId 和必填 checkinDate、checkoutDate 请求结算式报价,可选人数、currencyCode、languageCode、displayTotalPrice。文档示例 data 类型为 StayCheckoutSections,priceCheckout 下含 priceItems 与 total。各项可含 type、localizedTitle,以及 total 中的 amountFormatted、amountMicros、currency;示例涉及住宿费、折扣、清洁费和服务费。是否含税必须核对实际报价,不应预设。此接口未纳入本次实测;只读取报价,不提交、确认或支付预订。
API 功能
结算式 priceItems 费用结构 文档中的 priceCheckout 将有名称的住宿费用和附加费用组织在独立报价分区。
按类型区分费用和折扣 依据实际返回的 type 区分住宿费、优惠、清洁费及服务费。
格式化金额与微单位并读 同时核对 amountFormatted、amountMicros 和 currency,不把本地化文字直接当普通数值。
获取报价而不提交订单 读取此 GET 接口不会启动支付或确认预订。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/stays-price-checkout API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-price-checkout?key=<API_KEY>&listingId=<listingId>&checkinDate=<checkinDate>&checkoutDate=<checkoutDate>¤cyCode=USD&languageCode=en-US'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-price-checkout?key=<API_KEY>&listingId=<listingId>&checkinDate=<checkinDate>&checkoutDate=<checkoutDate>¤cyCode=USD&languageCode=en-US'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 从返回报价直接列出清洁费和服务费,而不是根据搜索醒目价推测。
- 以相同房源、日期、同行构成和币种核对搜索价与结算式报价。
- 在旅行预算比较中分开呈现返回的折扣与基础住宿费用。
- 将费用采集纳入研究管道前,先用当前报价结构验证分项解析。
常见问题
结算式价格接口真的会预订房源吗?
不会。这是文档所述的只读 GET 报价接口,不是预订或付款操作。接口名称及响应中任何与结算有关的文字,都不能展示为已完成预订。
文档中的结算报价用哪些字段描述费用?
读取 data.priceCheckout.priceItems,各项可含 type、localizedTitle,以及 total 内的 amountFormatted、amountMicros 和 currency。此接口未纳入本次实测,请通过针对性请求确认当前分项和税费口径。