获取 Google Shopping 商品评论高级结果

接口说明

通过任务 ID 获取 Google Shopping 商品评论结果。

本接口返回指定商品的评论数据，适用于已完成任务的结果提取。返回通常：

商品标题
商品图片
商品总评分与评分分布
高频提及
评论标题
评论正文
评论图片
评论来源站点
评论
评论发布时间

返回结果与您在创建任务时提交的 gid 参数对应。gid 是 Google Shopping 商品标识，需在任务创建阶段传。

本平台会尽可能高精度模拟任务设置时的查询参数，因此返回结果会尽量贴近对应时间点的页面结果。您也可以使用响应中的 check_url 进行人工核验。为保证结果一致性，系统不会考虑用户搜索历史、个性化偏好等个性化因素。

请求方式

GET /v3/merchant/google/reviews/task_get/advanced/{id}

完整请求地址示例：

https://api.seermartech.cn/v3/merchant/google/reviews/task_get/advanced/{id}

计费说明

在创建任务时计费；任务创建成功后，您可在 30 天多次获取结果。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。本接口为结果获取接口，通常返回 cost: 0。

路径参数

参数名	类型	说明
`id`	string	任务唯一标识，UUID 格式。可在任务创建后的 30 天用于随时获取结果。

沙箱调试

可通过以下沙箱地址查看本接口的完整字段结构，返回为模拟数据，不产生费用：

https://api.seermartech.cn/v3/merchant/google/reviews/task_get/advanced/00000000-0000-0000-0000-000000000000

沙箱响应会尽可能该接口下可用的所有字段，便于您联调解析逻辑。

响应结构

API 返回 JSON 数据，顶层 tasks 数组。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用状态码。完整错误码请参考 `/v3/appendix/errors`。建议为异常场景设计完善的处理机制。
`status_message`	string	通用状态信息。
`time`	string	执行耗时，单位秒。
`cost`	float	本次请求总成本，单位。业务可按响应值账；结果获取接口通常为 `0`。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量。
`tasks`	array	任务结果列表。

tasks[] 字段

字段	类型	说明
`id`	string	任务 ID，UUID 格式。
`status_code`	integer	任务状态码，范围通常为 `10000-60000`。
`status_message`	string	任务状态说明。
`time`	string	当前任务执行耗时，单位秒。
`cost`	float	当前任务成本，单位。
`result_count`	integer	`result` 数组中的结果数量。
`path`	array	请求路径。
`data`	object	创建任务时提交的原始参数。
`result`	array	结果数据数组。

result[] 字段说明

字段	类型	说明
`product_id`	string	创建任务时提交的 `product_id`。
`type`	string	创建任务时提交的搜索引擎类型。
`se_domain`	string	创建任务时提交的搜索引擎域名。
`location_code`	integer	创建任务时提交的位置编码。
`language_code`	string	创建任务时提交的语言编码。
`check_url`	string	可直接访问的搜索结果页面地址，用于核验采集结果。
`datetime`	string	抓取结果时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。
`spell`	object	搜索引擎自动纠错信息。若发生纠错，将返回纠正后的与纠错类型。
`title`	string	Google Shopping 中的商品标题。
`image_url`	string	商品主图 URL。
`rating`	object	商品整体评分信息。
`top_keywords`	array	与商品强的高频评论。
`reviews_count`	integer	评论总数。
`item_types`	array	当前结果中的条目类型。
`items_count`	integer	`items` 中返回的评论条目数量。可通过创建任务时设置 `depth` 获取更多结果。
`items`	array	评论明细列表。

spell 对象

字段	类型	说明
`keyword`	string	搜索引擎纠错后的。
`type`	string	自动纠错类型，可选值：`did_you_mean`、`showing_results_for`、`no_results_found_for`、`including_results_for`。

rating 对象（商品整体评分）

字段	类型	说明
`type`	string	素类型，固定为 `rating_element`。
`position`	string	素在 SERP 中的位置，可为 `left`、`right`。
`rating_type`	string	评分类型，当前常见值为 `Max5`。
`value`	float	基于评论的平均评分。
`votes_count`	integer	评分票数。
`rating_max`	integer	当前评分制的最大值。
`rating_groups`	array	各分值段的评分分布，通常为 1~5 5 个 `rating_element` 对象。

rating_groups[] 字段

字段	类型	说明
`rating_element`	string	素类型，固定为 `rating_element`。
`position`	string	素位置，可为 `left`、`right`。
`rating_type`	string	评分类型，常见值为 `Max5`。
`value`	integer	评分值，可为 `1`、`2`、`3`、`4`、`5`。
`votes_count`	integer	当前分值对应的票数。
`rating_max`	integer	当前评分制最大值。

top_keywords[] 字段

字段	类型	说明
`keyword`	string	代表商品特征或体验点的高频。
`count`	string	提及该的评论数量。

items[] 字段说明

每个代表一条商品评论。

字段	类型	说明
`type`	string	评论类型，固定为 `google_shopping_review_item`。
`rank_group`	integer	在同类型组的位置。不同 `type` 的不会计该排序。
`rank_absolute`	integer	在评论列表中的绝对排序位置。
`position`	string	评论在 SERP 中的位置，当前常见值为 `right`。示例响应中也可能出现 `left`。
`images`	array	评论上传的商品图片。
`title`	string	评论标题。
`url`	string	评论页地址。
`review_text`	string	评论正文。
`provided_by`	string	评论发布来源域名。
`author`	string	评论昵称。
`publication_date`	string	评论发布时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。该值为近似时间，通常由相对时间推算得出。
`rating`	object	评论给出的评分。

images[] 字段

字段	类型	说明
`type`	string	素类型，固定为 `images_element`。
`alt`	string	图片的 alt 文本。
`url`	string	链接地址。
`image_url`	string	评论中展示的商品图片地址。

单条评论中的 rating 对象

字段	类型	说明
`rating_type`	string	评分类型，常见值为 `Max5`。
`value`	float	评论评分值。
`votes_count`	integer	反馈数量；该字段通常为 `null`。
`rating_max`	integer	当前评分制最大值；例如 `Max5` 的最大值为 `5`。

请求示例

cURL

bash

id="04011058-0696-0199-0000-2196151a15cb"

curl --location --request GET "https://api.seermartech.cn/v3/merchant/google/reviews/task_get/advanced/${id}" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

python

import requests

task_id = "06141103-2692-0309-1000-980b778b6d25"
url = f"https://api.seermartech.cn/v3/merchant/google/reviews/task_get/advanced/{task_id}"

headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json

print(data)

TypeScript

typescript

import axios from "axios";

const taskId = "02231934-2604-0066-2000-570459f04879";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/merchant/google/reviews/task_get/advanced/${taskId}`,
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 // 返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

json

{
 "version": "0.1.20231117",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1668 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "reviews",
 "api": "merchant",
 "function": "reviews",
 "se": "google",
 "language_code": "en",
 "location_code": 2840,
 "gid": "4702526954592161872",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "top_keywords": [],
 "reviews_count": 20051,
 "item_types": [],
 "items_count": 10,
 "items": [
 {
 "title": null,
 "url": "https://www.mydeal.com.au/apple-iphone-xs-256gb-space-grey-as-new-7502338",
 "review_text": "Firstly I must say that this is my very first iPhone after deciding to change from Android to Apple...",
 "provided_by": "mydeal.com.au",
 "author": "David",
 "publication_date": "2024-01-18 00:00:00 +00:00",
 "rating": {
 "rating_type": "Max5",
 "value": 5,
 "votes_count": null,
 "rating_max": 5
 }
 },
 {
 "type": "google_shopping_review_item",
 "rank_group": 4,
 "rank_absolute": 4,
 "position": "left",
 "images": null,
 "title": "In need of a replacement",
 "url": "http://c1.ugc.bazaarvoice.com/18193-en_ca/15336375/review/265156421/redirect.htm?ctc_referralType=Shopping&ctc_referralDescription=Google",
 "review_text": "The phone arrived on time in near-perfect condition...",
 "provided_by": "bestbuy.ca",
 "author": "Nick",
 "publication_date": "2023-12-05 00:00:00 +00:00",
 "rating": {
 "rating_type": "Max5",
 "value": 5,
 "votes_count": null,
 "rating_max": 5
 }
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整个请求的执行状态。
tasks[].status_code 表示单个任务的执行状态。
建议同时校验：
HTTP 状态码
顶层 status_code
任务级 tasks[].status_code
result 是否为空

错误码明细请参考 /v3/appendix/errors。

使用建议

调用任务创建接口提交 gid 等参数。
再通过任务就绪接口查询已完成任务。
对已完成任务，使用本接口按 id 拉取高级结果。
若需更多评论，需在创建任务时提高 depth 参数。
可结合 check_url 对结果进行人工抽样校验。

实用场景

提取商品口碑要点：分析 top_keywords 与评论正文，快速识别用户最的卖点与槽点，用于优化商品页文案与广告素材。
监控评分结构变化：跟踪 rating 与 rating_groups，判断高分/低分占比变化，及时发现商品体验或履约问题。
汇总多站点评价来源：利用 provided_by 字段统计评论来自哪些站点，评估外部口碑分布与第三方平台影响力。
识别负面评论主题：筛选低评分评论及 review_text，定位如物流、翻新质量、电池寿命等问题，为售后和运营提供依据。
构建商品评价数据库：按任务批量拉取 items 明细，沉淀结构化评论数据，用于竞品分析、感分析和长期趋势研究。

获取 Google Shopping 商品评论高级结果 ​

接口说明 ​

请求方式 ​

计费说明 ​

路径参数 ​

沙箱调试 ​

响应结构 ​

顶层字段 ​

tasks[] 字段 ​

result[] 字段说明 ​

spell 对象 ​

rating 对象（商品整体评分） ​

rating_groups[] 字段 ​

top_keywords[] 字段 ​

items[] 字段说明 ​

images[] 字段 ​

单条评论中的 rating 对象 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码与错误处理 ​

使用建议 ​

实用场景 ​