读取爱彼迎住宿日历与入住晚数限制
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →提供 stays-search 返回的 listingId，可选 year、month 指定起始月份，count 请求 1 至 12 个月；文档默认当前年月、12 个月。文档响应 data.calendar_months 中含 condition_ranges、start_date、end_date，以及 min_nights、max_nights、closed_to_arrival、closed_to_departure 等条件。应检查返回日历来筛选候选入住窗口。此接口未纳入本次实测。不可订日期可能来自房东锁日或规则限制，不证明已确认订单、实际入住率或获得的收入。
API 功能
一至十二个月的日历跨度 使用 count 限定单套住宿请求的日历月份数量。
显式选择日历起始月份 可填写 year、month，或使用文档所述的当前月份行为。
晚数和到离店条件 文档 condition_ranges 含 min_nights、max_nights 和禁止到店／离店标志。
可订观察不等于入住率 将日历记录与已订晚数、实际入住和营收主张分开。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/stays-availability-calendar API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-availability-calendar?key=<API_KEY>&listingId=<listingId>&count=12'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-availability-calendar?key=<API_KEY>&listingId=<listingId>&count=12'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 用选中住宿返回的日历信息构建多月行程规划视图。
- 请求报价前，按最少晚数和到离店规则筛查候选日期窗口。
- 对候选房源保存带时间的日历观察，不将锁定日期标为已预订。
- 依据返回规则排除日期选择器中的不合适窗口，再复查具体日期价格。
常见问题
如何指定日历查询区间？
传入 listingId，可选 year、month 和 count。文档中 count 范围为 1 至 12；不指定区间时使用当前年月及文档所述的 12 个月跨度。
能从不可订日期推算实际入住率吗？
不能。不可订可能来自房东锁日、规则或其他限制。文档日历不证明已确认预订、完成入住或实际营收，此接口当前行为仍需单独验证。