Google 评价：概览

本接口用于获取指定本地商家的 Google 评价数据，是旧版 Google Reviews SERP API v2 的更新版本。数据采集采用标准异步模式：通过 POST 创建任务，任务完成后通过 GET 获取结果；文档端点 /v3/reviews-google-task_post/ 与 /v3/reviews-google-task_get。

返回结果由本地商家名称、搜索引擎、位置和语言参数决定。系统会尽可能模拟指定的位置与搜索环境，使返回数据与创建任务时对应条件下的搜索结果保持一致。

可通过响应中的 check_url 在浏览器无痕模式下查看对应结果页面，核验数据性。系统不会纳用户偏好、搜索历史及个性化因素，因此返回结果不个性化搜索影响。

Google 最多可返回 4490 条评价。使用 depth 字段指定需要获取的评价数量。

支持的设备与操作系统

创建任务时，可指定以下设备类型及操作系统：

设备类型	支持的操作系统
移动端（Mobile）	iOS、Android
桌面端（Desktop）	Windows、macOS

参数参考

参数	说明
本地商家名称	要查询评价数据的本地商家或地点名称。
搜索引擎	用于检索评价数据的搜索引擎。
位置	指定搜索位置，位置列表参考 /v3/reviews-google-locations/。
语言	指定结果语言，语言列表参考 /v3/reviews-google-languages/。
depth	需要获取的评价数量，最大可获取 4490 条。
设备类型	可选移动端或桌面端。
操作系统	与所选设备类型对应的操作系统。
pingback_url	可选。任务完成后，本平台将向该地址发送完成通知。
postback_url	可选。任务完成后，本平台将结果主动推送至该地址。

数据获取方式

Google 评价接口支持 Standard（标准） 数据获取方式。该方式采用异步任务流程：

1. 使用 POST 请求创建评价采集任务。
2. 等本平台完成数据采集。
3. 使用 GET 请求获取任务结果。

如未设置回调地址，可通过 /v3/reviews-tasks_ready/ 获取已完成但尚未提取结果的任务 ID 列表，再使用任务查询接口获取对应结果。

回调方式

创建任务时可选以下回调字段：

• pingback_url：任务完成后发送通知，需由您的服务再获取任务结果。
• postback_url：任务完成后直接将结果推送至指定地址。

如果未传 pingback_url 和 postback_url，建议定期调用 /v3/reviews-tasks_ready/ 查询提取的已完成任务。

请求限制

限制项	限制值
平台限流以认证说明中的 30/60/120 次/分钟规则为准
单次 POST 请求的任务数	最多 100 个

如需提高并发或任务数量限制，请联系技术支持。

优级与计费

费用取决于创建任务时指定的 depth 值，以及所选择的任务执行优级。

本接口按返回到 items 数组中的评价数量，以 每 10 条评价为一个计费单位 进行计费。例如：

• 指定 "depth": 11 时，按 20 条评价对应的计费单位计算。
• 指定 "depth": 100，但有 30 条可获取评价时，出结果部分的预扣费用将自动退回。

标准任务支持两种优级：

优级	说明
普通优级（Normal）	适用于常规时效要求，成本相对较低。
高优级（High）	适用于需要更快完成任务的场景，成本相对较高。

费用根据任务参数、优级及返回评价数量计算，并以响应头 X-SeerMarTech-Charge-CNY 中的人民币扣费金额为准。

注意事项

• depth 表示期望获取的评价数量，不保证一定能获得同等数量的结果。
• 若目标商家的评价数量少于 depth，按可返回的评价结果计费，额预扣部分会自动退回。
• 搜索结果不用户登录状态、历史搜索记录、个性化偏好等因素造成的差异。
• 建议使用 check_url 在浏览器无痕模式下进行结果核验。

实用场景

• 监测门店口碑变化：定期获取连锁门店的最新评价、评分与评论，及时发现服务质量或客户满意度问题。
• 分析竞品评价反馈：采集竞争商家的用户评价，识别高频好评点与投诉问题，为产品和运营策略提供依据。
• 筛选负面评价预警：按时间持续获取商家评价数据，快速发现低分评论并触发客服或品牌处理流程。
• 构建本地 SEO 评价报表：汇总不同城市、语言和设备环境下的评价数据，评估本地搜索与品牌声誉表现。
• 挖掘用户需求：从评价文本中提取高频需求、服务痛点和产品特征词，为优化与广告投放提供素材。