查询房源列表筛选项
查看 Booking 酒店与旅行数据 的全部接口 →使用已知 dest_id/dest_type 和必填住宿日期读取文档所述房源筛选元数据。成人数、儿童数与年龄、房间数、币种、语言及现有 categories-filter 应与目标搜索一致。文档指向 data.filters.options.genericId 作为筛选值。响应及筛选覆盖尚未实测，构造房源搜索前需检查实际选项。
API 功能
初始化房源流程筛选 读取目的地房源列表专用选项。
筛选查询也必填日期 目的地标识之外需提供两端日期。
核对房源 genericId 来源 确认返回值后再构造 categories-filter。
人数变化后更新筛选 旅客、房间数或日期变化时重新评估选项。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/booking/properties-list-filters API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/booking/properties-list-filters?key=<API_KEY>&checkin_date=<checkin_date>&checkout_date=<checkout_date>&dest_id=20088325&dest_type=city'
curl -X GET 'https://api.opendata-api.com/api/project/booking/properties-list-filters?key=<API_KEY>&checkin_date=<checkin_date>&checkout_date=<checkout_date>&dest_id=20088325&dest_type=city'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 为已确认目的地和日期初始化度假房源筛选。
- 查询公寓前先发现支持的房源类型值。
- 家庭人数配置变化后刷新房源筛选项。
- 审查已保存房源请求中过期的 genericId。
常见问题
categories-filter 的值应从哪里获取？
文档指向此房源筛选流程的 data.filters.options.genericId。接口未实测，需检查实际返回选项。
可以不传住宿日期就查筛选项吗？
不能。dest_id、dest_type、checkin_date、checkout_date 均必填，且应与接下来要查询的房源列表一致。