Google Play App Reviews API

Google Play App Reviews

主要特性

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

参数

如何使用

提交 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

最佳使用场景

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

使用建议

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

相关 API