获取 Google Play 应用评论结果（高级版）

通过任务 ID 获取 Google Play 应用评论采集结果。

本接口返回指定应用在 Google Play 上的评论数据：

• 评论评分
• 评论正文
• 评论用户资料
• 评论发布时间
• 开发回复
• 应用总体评分与评论总量

返回结果与创建任务时提交的 app_id、location_code、language_code 等参数一致。

本平台会尽可能高精度模拟任务设置时的查询环境，以便返回与对应地区、语言下结果尽量一致的数据。你也可以通过响应中的 check_url 校验结果性。需注意：个性化因素（如用户偏好、搜索历史等）不会被纳结果。

接口地址

GET https://api.seermartech.cn/v3/app_data/google/app_reviews/task_get/advanced/{id}

计费说明

在创建任务时扣费，任务结果在后续 30 天可重复获取。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

路径参数

字段	类型	说明
id	string	任务唯一标识，UUID 格式。创建任务后，可在 30 天随时通过该 ID 获取结果。

返回结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段

字段	类型	说明
version	string	当前 API 版本。
status_code	integer	接口通用状态码。完整错误码请参考 /v3/appendix/errors。建议在系统中实现异常与错误处理机制。
status_message	string	接口通用状态信息。
time	string	执行时间，单位秒。
cost	float	本次请求总成本，单位 USD。
tasks_count	integer	tasks 数组中的任务数。
tasks_error	integer	tasks 数组中返回错误的任务数。
tasks	array	任务结果数组。

tasks[] 字段

字段	类型	说明
id	string	任务 ID，UUID 格式。
status_code	integer	任务状态码，范围通常为 10000-60000。完整错误码请参考 /v3/appendix/errors。
status_message	string	任务状态说明。
time	string	任务执行时间，单位秒。
cost	float	单个任务成本，单位 USD。
result_count	integer	result 数组中的结果数。
path	array	URL 路径。
data	object	创建任务时提交的参数回显。
result	array	结果数组。

result[] 字段

字段	类型	说明
app_id	string	POST 创建任务时传的应用 ID。
type	string	POST 创建任务时传的搜索引擎类型。
se_domain	string	POST 创建任务时传的搜索引擎域名。
location_code	integer	POST 创建任务时传的位置编码。
language_code	string	POST 创建任务时传的语言编码。
check_url	string	结果校验地址，可用于确认采集结果是否准确。
datetime	string	结果抓取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
title	string	应用标题，即评论所属应用名称。
rating	object	应用总体评分信息。
reviews_count	integer	应用评论总数。
items_count	integer	当前结果中返回的评论条数。可在创建任务时通过 depth 获取更多结果。
items	array	评论列表。

result[].rating 字段

字段	类型	说明
rating_type	string	评分类型，可能值：Max5、Percents、CustomMax。
value	float	基于评论计算出的平均分。
votes_count	integer	评分票数。
rating_max	integer	对应 rating_type 的最大分值。

result[].items[] 字段

字段	类型	说明
type	string	评论类型。固定可能值：google_play_reviews_search。
rank_group	integer	在相同 type 分组的位置。
rank_absolute	integer	在评论列表中的绝对位置。
position	string	评论在结果页中的布局位置，当前为 left。
version	string	发表评论时对应的应用版本。
rating	object	用户提交的评论评分。
timestamp	string	评论发布时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
id	string	评论 ID。
helpful_count	integer	该评论被标记为“有帮助”的次数。
title	string	评论标题。Google Play 不提供标题字段，因此该值恒为 null。
review_text	string	评论正文。
user_profile	object	评论用户资料。
responses	array	开发回复列表。

result[].items[].rating 字段

字段	类型	说明
rating_type	string	评分类型，当前为 Max5。
value	float	用户评分值。
votes_count	integer	反馈量；该字段在此场景下通常为 null。
rating_max	integer	评分上限；Max5 的最大值为 5。

result[].items[].user_profile 字段

字段	类型	说明
profile_name	string	评论用户昵称。
profile_image_url	string	评论用户头像地址。

result[].items[].responses[] 字段

字段	类型	说明
author	string	回复，通常为开发。
title	string	回复标题；该值通常为 null。
text	string	回复。
timestamp	string	回复发布时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。

沙箱调试

你可以通过以下沙箱地址获取完整字段结构的模拟数据，不会产生费用：

GET https://sandbox.seermartech.cn/v3/app_data/google/app_reviews/task_get/advanced/00000000-0000-0000-0000-000000000000

沙箱响应会返回本接口可用的字段，字段值为模拟数据，适合联调与字段映射测试。

请求示例

curl

# 请替换为任务 ID
id="04011058-0696-0199-0000-2196151a15cb"

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

Python

import requests

task_id = "06141103-2692-0309-1000-980b778b6d25"
url = f"https://api.seermartech.cn/v3/app_data/google/app_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

import axios from "axios";

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

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/app_data/google/app_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.response?.data || error.message);
 });

响应示例

{
 "version": "0.1.20230705",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0915 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "reviews",
 "se": "google",
 "api": "app_data",
 "function": "app_reviews",
 "app_id": "org.telegram.messenger",
 "location_code": 2840,
 "language_code": "en",
 "depth": 150,
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {}
 ]
 }
 ]
}

状态码与错误处理

• 顶层 status_code 表示本次 API 请求整体状态
• tasks[].status_code 表示单个任务状态
• 建议优判断：

1. HTTP 状态码是否正常
2. 顶层 status_code 是否成功
3. tasks_error 是否为 0
4. tasks[].result 是否存在且非空

完整错误码与说明请参考：/v3/appendix/errors

使用说明

• 本接口用于获取已创建任务的结果，不负责创建任务
• 如果需要批量获取已完成任务，可调用 /v3/app_data/google/app_reviews/tasks_ready 获取可拉取任务列表
• 若结果评论数量不足，可在创建任务时增大 depth 参数
• 同一任务结果可在 30 天重复获取，无需重复扣费

实用场景

• 监控应用口碑变化：按地区和语言抓取评论与评分，及时发现差评集中出现的市场，运营快速响应。
• 分析版本发布反馈：结合评论中的 version 字段，识别新版本上线后的用户满意度变化，定位更新带来的体验问题。
• 提取高频负面问题：基于 review_text 聚合崩溃、卡顿、订扣费等，帮助产品和研发确定优修复事项。
• 评估客服与开发回复效果：利用 responses 与 helpful_count 分析官方回复覆盖率和用户认可度，优化评论区运营策略。
• 建立竞品评价对比库：采集竞品应用在不同市场的评论、评分分布和用户画像，为 ASO 与产品策略提供依据。