按目的地和日期搜索爱彼迎住宿
查看 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 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
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¤cyCode=USD&languageCode=en-US&limit=3&typeOfPlace=Any'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-search?key=<API_KEY>&placeId=eyJwIjoiQ2hJSkQ3ZmlCaDl1NWtjUllKU01hTU9DQ3dRIiwicSI6IlBhcmlzLCBGcmFuY2UifQ%3D%3D&adults=2¤cyCode=USD&languageCode=en-US&limit=3&typeOfPlace=Any'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 搭建按目的地、日期和同行人数搜索的住宿列表,用统一币种比较候选。
- 为民宿候选清单实现加载更多,并跨游标响应按 listing.id 去重。
- 利用住宿搜索返回的设施值,缩小适合远程办公的房源范围。
- 将选中住宿的标识带入详情、指定日期价格和住客评论查询。
常见问题
住宿搜索需要的 placeId 从哪里获取?
调用 common-auto-complete,完整复制选中建议的 explore_search_params.place_id。实测值经过编码,不要根据 location.google_place_id 重新构造,也不要替换为目的地文字。
可以用 page=2 获取下一页住宿吗?
此接口未声明 page 入参。保持搜索条件一致,将 data.paginationInfo.nextPageCursor 作为 pageCursor 传入。meta.currentPage 仅描述当前响应,展示的总数也不代表完整房源库存。