按城市或目的地文字搜索爱彼迎房源
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →传入 Paris, France 等目的地 query 查找房源。可选 checkin、checkout 为 YYYY-MM-DD 格式，并可用人数、currency、locale、page、预算及返回的筛选标识缩小范围。实测成功响应含 status:true、巴黎相关 message、currentPage、resultsPerPage、totalPages、totalResultCount，以及 data.filters 和非空 homes 数组。房源含 title、nameLocalized、照片、demandStayListing 标识与坐标、structuredDisplayPrice；结构不同于 stays-search，当前样本没有 homes[].listing.id。无法识别的目的地返回 HTTP 200，但 status:false、message 为 Query is not available、计数为零且 data:null。应视为查询失败，而非该市场房源为零。
API 功能
以目的地文字起步找房 直接使用城市或目的地名称，不要求先完成地点标识查询。
按 homes 专用结构解析 读取实测 data.homes 集合，不套用另一类搜索的 searchResults 结构。
房源筛选目录随目的地配置 使用对应目的地返回的设施、私密类型、房东语言等筛选标识。
显式识别不可用查询 结合业务消息和计数识别 status:false、data:null，不把失败响应误作成功列表。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/properties-search API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/properties-search?key=<API_KEY>&query=Paris%2C+France&adults=2¤cy=USD&locale=en-US&page=1'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/properties-search?key=<API_KEY>&query=Paris%2C+France&adults=2¤cy=USD&locale=en-US&page=1'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 以城市为入口，按行程日期、同行人数、预算和房间私密性建立民宿清单。
- 定时记录当地可比房源的展示价格样本，保留观察时间而不声称有历史全量覆盖。
- 让旅客按允许宠物、自助入住和即时预订标志细化文字搜索，而不创建订单。
- 在研究管道中标记无法解析的目的地，避免把查询错误写成该市场零房源。
常见问题
HTTP 200 是否表示目的地搜索成功？
不一定。实测不存在的目的地返回 HTTP 200，但 status:false、data:null、message 为 Query is not available，结果计数也为零。处理 homes 或解读计数前，先检查业务状态。
可以假设每个 home 都含 listing.id 吗？
不可以。较早文档示例使用 homes[].listing.id，当前实测 homes 则使用 demandStayListing.id，没有 listing 对象。请检查实际响应；未解析出正确的十进制房源标识前，不要把编码后的 demandStayListing 标识直接作为房源 ID。