获取某个谷歌地图商家的评论,包含评分、评论者信息、商家回复,并支持游标翻页。

查看 谷歌地图数据 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 功能

按商家 ID 获取评论 用谷歌地图 ID、CID 或 place ID 发起一次 GET 请求,就能拿到一页评论,不必打开地点页面,也不用滚动评论面板。
每条评论的评分与文本 每条评论都有评分、正文、语言和来源,测试调用还出现了 translated_text 字段,但五条样本中该字段均为 null。
基于 next_token 的游标翻页 响应返回 next_token,把它作为 next_page_token 回传即可读取下一页,因此可以逐页遍历一个商家的评论历史。
可调整的每页数量 limit 参数默认为 20,测试中 limit=5 返回了五条评论。文档没有说明 limit 的最大允许值。
评论者资料字段 每条评论都附带评论者姓名、头像、主页链接、评论数与照片数,以及本地向导(Local Guide)标记,便于判断作者的经验丰富程度。
分项评分与问答回答 rating_breakdown 和 question_breakdown 数组在谷歌地图展示相关内容时,会给出 Food 等分项评分,以及订位建议之类的问答回答。
评论配图与商家回复 评论照片同时提供缩略图和原图链接,并带有 owner_response_* 字段,可以把已回复和未回复的评论区分开。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

商家评论接口返回什么内容?

返回一个 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 为可选参数,文档没有列出它们的可接受取值。

相关接口

相关指南

查看订阅方案 →