按目的地标识对搜索房源
查看 Booking 酒店与旅行数据 的全部接口 →使用已知 dest_id、dest_type 及必填入住离店日期查询房源列表。可选成人数、儿童数与年龄、房间数、最低卧室浴室床位数、categories-filter、币种、语言、页码与排序。住宿自动补全不可用,须独立准备目的地标识对。此响应尚未实测,不能假定与 stays-search 的分页或标识一致。
API 功能
房源流程使用目的地标识对 dest_id 与 dest_type 必须配套保存。
目的地房源必填住宿区间 查询时明确两端日期。
按目的地选择最低空间偏好 使用此接口文档规定的卧室、浴室及床位字段。
独立检查房源分页 不能套用实测 stays-search 的分页表现。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/booking/properties-list-dest API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/booking/properties-list-dest?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-dest?key=<API_KEY>&checkin_date=<checkin_date>&checkout_date=<checkout_date>&dest_id=20088325&dest_type=city'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 复用已确认目的地,为团体住宿研究查询房源。
- 同一日期比较两个已知城市的多卧室房源。
- 在目的地 ID 房源流程中测试最低空间偏好。
- 补充选中住宿记录前核对房源列表标识。
常见问题
dest_id 可以填写 city:20088325 吗?
应分开传值:纽约文档示例为 dest_id=20088325、dest_type=city。带前缀 query 属于 stays-search。
它也像实测住宿搜索一样每页返回 20 条吗?
尚未证实。这是不同的房源列表接口,响应未实测,应检查它自己的分页字段与行数。