检索爱彼迎住宿评论并按时间或评分排序
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →传入住宿搜索取得的 listingId,可选 query、page、limit、sortBy、currencyCode 和 languageCode。limit 最多 40 条评论,page 默认 1;sortBy 支持 MOST_RECENT、RATING_DESC、RATING_ASC。实测返回 status:true、message:Successful、分页 meta,以及 data.pdpReviews 和 metadata。评论含 id、comments、rating、createdAt、language 和本地化日期,元数据含 reviewsCount、reviewSortSelect。实测使用 MOST_RECENT 且无关键词,因此关键词匹配与其他排序仍属文档选项,未逐项验证。
API 功能
带时间的住宿评论记录 实测 pdpReviews 包含评论 ID、文字、数值评分和 createdAt 时间。
文档支持三种住宿评论顺序 可请求 MOST_RECENT、RATING_DESC 或 RATING_ASC 对应的评论排序。
住宿评论关键词入口 使用 query 聚焦研究主题,并针对所选词核实当前匹配行为。
评论页码与数量信息 结合响应 meta 和 metadata.reviewsCount,使用 page 与最多 40 的 limit 控制读取。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/stays-reviews API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-reviews?key=<API_KEY>&listingId=1173047051903832695¤cyCode=USD&languageCode=en-US&page=1&limit=3&sortBy=MOST_RECENT'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-reviews?key=<API_KEY>&listingId=1173047051903832695¤cyCode=USD&languageCode=en-US&page=1&limit=3&sortBy=MOST_RECENT'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 在住宿候选详情旁展示带日期的近期反馈,不将评论者身份字段复制进自建数据集。
- 通过文档支持的关键词输入研究噪音、楼梯等影响旅客适配性的反馈。
- 向特定旅客推荐住宿前,用 RATING_ASC 检查低评分评论。
- 按页收集住宿评论,以评论 id 去重后开展反馈分析。
常见问题
住宿评论如何分页和排序?
发送 page、limit,不使用搜索 pageCursor。文档中 limit 最多 40,sortBy 接受 MOST_RECENT、RATING_DESC 或 RATING_ASC。实测验证了 page=1、limit=3 和 MOST_RECENT。
住宿评论文字与日期在哪些字段?
读取 data.pdpReviews 各项的 comments、rating、createdAt 和 id。计数与排序选项位于 data.metadata;这不是 properties-reviews 文档所述的直接 data 数组。