Google Play App Detail API

Google Play App Detail

主要特性

• 以已知链接为边界一次提交一个或多个 play.google.com 应用链接逐条查详情，不把详情接口包装成关键词发现能力。
• 统一应用标识与文案整理包名、应用名称、公开商店描述、开发者、分类、原始链接和采集时间。
• 保留公开市场信号在来源可见时返回评分、评论数、安装量区间、价格与排名；未提供的字段保持为空。
• 面向数据流的记录格式把媒体和详情字段归入统一 app schema，并沿用 SocQ 异步任务及结果读取流程。

参数

如何使用

提交已知 Google Play 应用链接，等待异步任务完成，再读取标准化应用记录。

1. 准备非空 urls 数组，每个链接的可解析主机名必须是 play.google.com 或其子域名。
2. 向 /v1/google-play/app-detail 发送 POST 请求，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务进入成功或失败终态。
4. 任务成功后读取 data.results.items；仅当 has_more 为 true 时携带 next_cursor 继续读取。该 cursor 只翻页 SocQ 已存结果，不会请求下一页 Google Play 来源数据。

curl -X POST "https://api.socq.ai/v1/google-play/app-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://play.google.com/store/apps/details?id=com.openai.chatgpt"]}'

# 轮询 GET /v1/tasks/{task_id}
# 从 data.results.items 读取标准化应用记录

最佳使用场景

• 补全已知应用目录： 把已有 Google Play 链接补充为包含包名、标题、描述、开发者、分类、来源链接和采集时间的结构化记录。
• 比较指定应用： 在经过筛选的链接集合中对齐可用的评分、评论数、安装量区间、价格、分类和媒体字段。
• 观察商店页快照： 按明确节奏重复采集，并结合 collected_at 比较可能为空或随时间变化的公开商店字段。

使用建议

• 提交完整 Google Play 应用链接，并先对数组去重，让费用预估对应实际需要查询的链接。
• 一个输入链接最多产生一条记录；请用 url 或 app_id 对齐结果，因为通过主机校验不代表一定能解析出公开应用。
• 评分、评论数、安装量区间、价格、排名和媒体都应按可空字段保存，公开页面也可能在采集后变化。
• next_cursor 只用于继续读取当前任务已经存入 SocQ 的结果；此详情接口不支持关键词搜索或 Google Play 来源分页。

相关 API