按目的地和日期搜索爱彼迎住宿

查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →

使用目的地联想返回的 placeId 搜索住宿,原样传入 explore_search_params.place_id,不要换成城市名称。可选 checkinDate、checkoutDate 使用 YYYY-MM-DD 格式;比较结果时保持成人数、currencyCode 和 languageCode 一致。巴黎实测响应包含 status、message、meta,以及 data 内的 filters、paginationInfo、searchInput 和 searchResults。结果含 listing.id、标题、照片、demandStayListing.location.coordinate 坐标和 structuredDisplayPrice。将 paginationInfo.nextPageCursor 作为 pageCursor 继续搜索;meta.currentPage 只是响应信息,不是请求页码。不传日期时可能显示建议日期的价格,而非你的行程报价。

API 功能

联想地点直接衔接住宿搜索 沿用目的地选择器返回的完整 placeId,明确搜索区域,不自行拼接地点标识。
可关联详情的住宿卡片 实测 searchResults 含十进制 listing.id,以及标题、照片和地理坐标。
结合日期解读展示价格 读取 structuredDisplayPrice 与实际返回的日期条件,不将无日期的醒目价格误作行程总价。
按返回游标继续找房 后续请求使用 nextPageCursor 或 previousPageCursor,不自行推算页码。

在线 API 演示

GET /api/project/airbnb-search/stays-search

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-search?key=<API_KEY>&placeId=eyJwIjoiQ2hJSkQ3ZmlCaDl1NWtjUllKU01hTU9DQ3dRIiwicSI6IlBhcmlzLCBGcmFuY2UifQ%3D%3D&adults=2&currencyCode=USD&languageCode=en-US&limit=3&typeOfPlace=Any'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

住宿搜索需要的 placeId 从哪里获取?

调用 common-auto-complete,完整复制选中建议的 explore_search_params.place_id。实测值经过编码,不要根据 location.google_place_id 重新构造,也不要替换为目的地文字。

可以用 page=2 获取下一页住宿吗?

此接口未声明 page 入参。保持搜索条件一致,将 data.paginationInfo.nextPageCursor 作为 pageCursor 传入。meta.currentPage 仅描述当前响应,展示的总数也不代表完整房源库存。

相关接口

相关指南

查看订阅方案 →