google-play/
app-reviews

通过 play.google.com 应用 URL 采集公开 Google Play 应用评价,可选传入 country 上下文,并以标准化记录返回评价文本、作者、评分、时间和应用引用。

Google Play App Reviews API

批量应用 URL
评价文本与评分
国家上下文
每条结果 0.15 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Google Play App Reviews

Google Play 应用评价是公开的应用商店反馈,将文字意见和星级评分与评价者身份、发布时间及被评价应用引用联系起来。这些记录适合开展反馈研究、评分比较、版本发布监测和带来源链接的评价数据集建设。

Google Play App Reviews API 主要特性

  • 多应用 URL 输入接受一个或多个 play.google.com 应用 URL,并在这些应用之间分配所请求的评价数量。
  • 评价内容与评分以一致的评价记录返回每条可用评价的文本和数值评分。
  • 评价者与时间上下文将可用的评价者身份、主页引用、发布时间和采集时间与反馈一并保留。
  • 被评价应用可追溯通过 subject_id 和 subject_url 将标准化评价关联到可用的应用标识与公开应用 URL。

Google Play App Reviews API 参数

参数必填描述
urls必填必填数组,包含一个或多个非空应用 URL;主机名必须是 play.google.com 或其子域。
country可选可选字符串,存在时会作为国家上下文传给评价来源;不需要市场上下文时可省略。
results_limit可选可选的 1 至 2,000 正整数,默认值为 100,用于限制所有输入 URL 的任务总存储结果数。

如何使用 Google Play App Reviews API

提交 Google Play 应用 URL,跟踪异步任务,并分页读取 SocQ 已存储的标准化记录。

  1. 准备一个或多个公开应用 URL,其主机名必须是 play.google.com 或其子域。
  2. 向 /v1/google-play/app-reviews POST urls、可选 country 和 results_limit,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或失败;轮询期间不要重复提交任务。
  4. 成功后读取 data.results.items;当 has_more 为 true 时,将 next_cursor 继续传给任务读取路由。
curl -X POST "https://api.socq.ai/v1/google-play/app-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://play.google.com/store/apps/details?id=com.example.notes"],"country":"US","results_limit":100}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items;has_more 为 true 时继续使用 next_cursor

Google Play App Reviews API 最佳使用场景

  • 反馈主题研究: 利用评价文本和评分构建带来源引用的语料,用于定性编码或下游文本分析。
  • 评分与文本比较: 在选定的公开应用页面之间比较文字反馈及其对应的数值评分。
  • 评价时间线监测: 结合发布时间与采集时间,比较产品版本发布前后分别采集的评价样本。
  • 应用关联数据补全: 使用 subject_id 和 subject_url 为应用记录补充评价者、文本、评分和时间字段。

Google Play App Reviews API 使用建议

  • 使用 play.google.com 上的完整公开应用 URL;其它主机会在采集开始前被输入校验拒绝。
  • 提交多个 URL 时,应将 results_limit 视为整个任务的目标,因为来源请求会在应用输入之间分配数量,而最终存储结果仍受全局上限约束。
  • 只在需要市场上下文时设置 country,并在需要比较的重复采集中保持其取值一致。
  • 使用任务响应的 next_cursor 读取更多已存储记录;它是 SocQ 结果 cursor,不是评价来源接受的 cursor。
  • 将可选的评价者、来源链接和媒体字段按可空值处理,不要用虚构默认值替代缺失数据。

除了 Google Play App Reviews API,需要其他类型的 Google Play 公开数据时,可以使用以下 API。

探索其他平台

还可以将 Google Play 数据与其他已支持社交平台的公开数据结合使用。

Google Play App Reviews API — 常见问题

Google Play App Reviews API 是一个用于从一个或多个已提交 Google Play 应用 URL 采集公开应用评价的 API,可选传入 country 上下文。它返回标准化评价文本、评价者信息、评分、发布时间、媒体和被评价应用引用。

urls 是必填的非空 URL 数组,主机名必须是 play.google.com 或其子域。country 是传给来源请求的可选字符串,也可以省略。

results_limit 默认是 100,接受 1 至 2,000 的整数。来源请求会在提交的 URL 之间分配所请求数量,而 SocQ 按该数值限制整个任务的最终存储结果。

标准化记录可以包含评价 ID、来源 URL、文本、评价者身份、数值评分、发布时间与采集时间、应用标识、应用 URL 和媒体引用。公开结果没有提供的选填字段会保持为空。

不会。请求不接受调用方提供的来源 cursor;异步任务成功后,next_cursor 和 has_more 只用于分页读取 SocQ 已存储的结果行。

未提供 results_limit 时按 100 条结果预估,每条已存储结果消耗 0.15 SocQ 积分。最终按实际结果数结算,成功但结果为空时回落到 0 积分的基础费用。