获取某个谷歌地图商家的评论,包含评分、评论者信息、商家回复,并支持游标翻页。
查看 谷歌地图数据 API:商家搜索、评论与照片采集 的全部接口 →返回某个谷歌地图商家的一页评论。必填参数 business_id(谷歌地图 ID、CID 或 place ID),可选参数 country、lang、limit(默认 20)、next_page_token 和 sort_by。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、评论数组 data、用于获取下一页的 next_token,以及回显的 request_params。在 limit=5 的实际测试调用中,data 返回了 5 条评论,next_token 是一个字符串。每条评论包含 id、text、translated_text、time(相对时间文本,如 "4 months ago")、timestamp(Unix 秒级时间戳)、url、rating(样本中出现过 3 和 5)、language、language_translated_text、source(Google)、photos 列表(含 thumbnail_url、full_photo_url、width、height 和 aspect_ratio)、rating_breakdown 条目(id、question、rating)、question_breakdown 条目(id、question、answer、explanation)、评论者字段(user_id、user_name、user_avatar、user_profile_url、user_reviews_count、user_images_count、user_reviews_url、user_is_local_guide、user_local_guide_level),以及 owner_response_* 系列字段,这些字段在样本中全部为 null。要读取下一页,请把返回的 next_token 值作为 next_page_token 传入。sort_by 的可接受取值文档中没有说明,也没有测试过。接口文档中公布的响应示例是空对象,因此上述字段均来自实际测试调用。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/google-maps-extractor/business-reviews API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/business-reviews?key=<API_KEY>&business_id=0x80c2c621d7d91b49%3A0x5e3e80cfbddfba70&limit=20'
查询结果
使用场景
- 为客户门店和竞争对手门店设置新评论提醒:逐页读取直到遇到已存储的评论,并对低分评论发送通知
- 一次性把某个商家的评论历史回填到数据库,用于情感与主题分析
- 在多门店连锁品牌的所有分店中挖掘等待时间、价格或卫生等投诉关键词
- 为每个门店生成评分漂移报告,把最新 50 条评论与上个月的快照进行对比
- 构建用于 NLP 训练或评测的评论数据集,并可按请求指定语言
- 做回复缺口审计:列出 owner_response_text 为空的评论,交给客服团队逐条回复
常见问题
商家评论接口返回什么内容?
返回一个 JSON 对象,包含 status、request_id、评论数组 data、next_token 以及回显的 request_params。在 limit=5 的实际测试调用中,data 有五条评论,每条都带有 rating、text、time、timestamp、language、评论者字段、photos 和 owner_response_* 字段。
如何获取第一页以外的更多评论?
取出响应中的 next_token,在下一次请求中把它作为 next_page_token 传入,同时保持 business_id 和其他参数不变。注意请求参数叫 next_page_token,而响应字段叫 next_token。测试调用只获取了第一页,请根据你自己的停止条件重复请求。
怎么判断已经到了最后一页?
文档说明还有更多评论时会返回令牌。最后一页的 next_token 是缺失、null 还是空值,测试调用中没有观察到,因此建议在 data 为空,或 next_token 不是非空字符串时停止翻页。
sort_by 接受哪些值?
文档只把它描述为评论的排序条件,并没有列出允许的取值。测试调用没有使用 sort_by,所以在依赖某个值之前(例如用于按最新优先的监控),请先用小规模请求确认。
time 和 timestamp 有什么区别?
time 是相对时间文本,例如 "4 months ago";timestamp 是以秒为单位的 Unix 时间。对已存储的评论做排序和去重时,请使用 timestamp 或评论 id。
商家回复和翻译字段一定有值吗?
不一定。测试调用中所有 owner_response_* 字段以及 translated_text 都是 null,因此请把它们当作可选字段并做空值判断。对于确实有商家回复或翻译的评论,这些字段是否会被填充,我们没有观察到。
哪些参数是必填的,默认值是什么?
只有 business_id 必填,示例值为 0x80c2c621d7d91b49:0x5e3e80cfbddfba70。limit 默认为 20,next_page_token 默认为空字符串。country、lang 和 sort_by 为可选参数,文档没有列出它们的可接受取值。