查看爱彼迎体验返回的可选活动日期
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →提供体验 listingId,可选未来 fromDate/toDate、adults、children、infants、currencyCode、languageCode。文档 data.availableDates 含 calendarItems,其记录有 startDateLocal 和可为 null 的 remainingGuestCount,并有 areChildrenAllowed、areInfantsAllowed。文档也提及 availableDates.items,因此应检查当前 availableDates 分区,而不是假定某一集合始终存在。此接口未纳入本次实测。返回日期和空容量值不保证可用名额,此 GET 也不预订活动。
API 功能
体验日期窗口查询 通过 fromDate、toDate 将文档所述活动日期请求聚焦到计划行程。
活动当地日历日期 示例 calendarItems 使用 startDateLocal 标明日期,不采用住宿入住字段。
剩余参加人数允许为空 remainingGuestCount 为 null 时,不应换算成保证的容量或零名额。
儿童与婴幼儿政策标志 返回文档所述标志时,检查 areChildrenAllowed、areInfantsAllowed。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/experiences-available-dates API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/experiences-available-dates?key=<API_KEY>&listingId=<listingId>¤cyCode=USD&languageCode=en-US'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/experiences-available-dates?key=<API_KEY>&listingId=<listingId>¤cyCode=USD&languageCode=en-US'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 用选定体验返回的日期填充暂定活动日期选择器。
- 检查礼宾服务候选活动是否返回了与旅客行程重叠的日期。
- remainingGuestCount 为空时标注活动容量不确定,而不是承诺有位。
- 向家庭出游团队推荐活动前,查看返回的儿童与婴幼儿参加标志。
常见问题
响应中的体验日期在哪里?
文档示例为 data.availableDates.calendarItems,其中含 startDateLocal;接口说明也指向 availableDates.items。请检查实际 availableDates 分区,并防御性处理缺失集合;此接口未实测。
返回日期或 null 的 remainingGuestCount 是否保证全团有位?
不保证。返回日期不是预订,remainingGuestCount 为 null 也不能确定容量。保持请求中的同行构成一致,并在向旅客承诺前核实当前可订情况。