Google Play APIs
通过已知商店链接采集公开 Google Play 应用详情、分类榜单和评价，并返回标准化应用与评价记录。
可用的 Google Play API
已知商品页使用 App Detail，公开榜单链接使用 App Rankings，已知应用链接的公开反馈使用 App Reviews。
可以获取哪些 Google Play 数据？
标准化 app schema 会保留公开商店字段的可空状态，不用猜测值填补来源缺失。
应用标识与商店文案
在来源提供时返回包名、应用名称、公开描述、开发者、分类与原始链接。
可见商店信号
将评分、评论数、安装量区间、价格和排名作为特定采集时点的公开观察值保存。
媒体与采集上下文
在应用记录中保留媒体字段和 collected_at。
Google Play API 契约概览
三个接口都从已知 Google Play 公开链接开始，并通过异步任务流程返回标准化记录。
| 接口 | 输入 | 来源范围 |
|---|---|---|
| App Detail | 非空应用链接数组 | 每个合法链接最多一条应用记录 |
| App Rankings | 分类或榜单链接及可选 results_limit | 提交榜单中公开的应用 |
| App Reviews | 应用链接及可选 country、results_limit | 提交应用的公开评价 |
Google Play API 如何运行
三个接口都使用标准异步任务流程。
1. 提交已知链接
选择对应接口，POST 必需的 urls 数组和可选控制参数，并保存 task_id。
2. 跟踪任务状态
轮询 /v1/tasks/{task_id}，直到处理成功或失败。
3. 读取已存记录
成功后读取 data.results.items；只有 SocQ 存储结果还有下一页时才使用 next_cursor。
使用 SocQ API key 鉴权，并提交已知的 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.itemsGoogle Play API 常见场景
补全应用目录
为已有应用链接增加标准化标识、公开商店文案、开发者、分类与来源上下文。
比较选定商店页
在受控链接集合中比较来源可见的价格、评分、评论数、安装量区间和媒体字段。
保留时点观察
结合 collected_at 保存重复采集结果，以比较可能为空或变化的公开商店字段。
限制与公开数据政策
结果取决于当前公开商店页可见性，不包含账号管理或发布能力。
- 每个输入项解析出的主机名必须是 play.google.com 或其子域名。
- 接口不接受关键词或单独包名；可选字段由所选接口决定。
- App Detail 每个链接最多返回一条记录；Rankings 和 Reviews 的任务级 results_limit 范围为 1 到 2,000。
- 任务结果 cursor 只翻页 SocQ 已存记录，不会请求更多 Google Play 页面。
- 最终按每条已存结果 0.15 credits 结算且没有基础费用；App Detail 按 URL 数量预估，Rankings 和 Reviews 按请求或默认结果上限预估。
Google Play API 常见问题
Google Play API 是什么？
Google Play API 用于通过已知链接获取应用详情、采集分类榜单以及采集公开应用评价。
可以一次提交多个应用链接吗？
可以。请提交非空字符串数组，每个链接都使用 play.google.com 主机或其子域名。
接口能发现应用吗？
App Rankings 可以发现提交榜单链接中公开的应用，但这些接口不提供关键词搜索。
结果如何计费？
每条已存结果为 0.15 SocQ credits，最终按实际结果数结算；预估方式取决于所选接口。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
LinkedIn API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。
Reddit API
通过已知 URL 获取公开 Reddit 帖子和评论，浏览 subreddit 中的 new、top 或 hot 帖子，或按关键词和发布时间搜索讨论。
Rednote API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。
Pinterest API
获取公开 Pinterest 账号数据、解析指定 Pin、采集选定账号的 Pin，或按关键词搜索，用于创作者、内容和视觉趋势研究。