google-play/
app-detail

根据已知 play.google.com 链接获取公开的 Google Play 应用详情,统一返回应用标识、商店文案、开发者、分类、可见指标、价格与媒体字段。

Google Play App Detail API

已知应用链接
批量详情查询
按结果计费
每条结果 0.15 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Google Play App Detail

Google Play 应用详情是公开商店页中呈现的应用标识、简介、开发者与分类,以及可见评分、评论数、安装量区间、价格和媒体等信息。这组数据适合补全应用目录、比较选定应用,并保留带采集时间的页面快照。

Google Play App Detail API 主要特性

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

Google Play App Detail API 参数

参数必填描述
urls必填必填的非空字符串数组。每项都应是已知应用链接,且解析出的主机名为 play.google.com 或其子域名;一个链接对应一次详情查询。

如何使用 Google Play App Detail API

提交已知 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 App Detail API 最佳使用场景

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

Google Play App Detail API 使用建议

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

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

探索其他平台

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

Google Play App Detail API — 常见问题

Google Play App Detail API 是通过已知 Google Play 应用链接获取公开商店详情的程序化接口,可在来源提供时返回标准化应用标识、商店文案、开发者、分类、可见指标、价格、媒体及采集上下文。

必须提交非空 urls 数组,其中每项都是字符串,且解析出的主机名为 play.google.com 或其子域名。

不能。该接口只逐条解析已知链接,每个链接最多返回一条标准化记录;合法链接也可能因资源不可用而没有结果。

app schema 可包含记录 ID、来源链接、包名、名称、文案、开发者、分类、评分、评论数、安装量区间、价格、排名、媒体及采集时间。来源未提供的公开字段可以为空。

预估费用按提交链接数以每项 0.15 SocQ credits 计算。最终费用按实际返回记录数以每条 0.15 credits 结算,基础费用为零,因此成功但没有返回记录的任务最终费用为零。