返回 API
Apple App Store 公开数据

Apple App Store API

通过已知商店链接采集公开 Apple App Store 应用详情、分类榜单和评价,并返回标准化应用与评价记录。

可用的 Apple App Store API

已知商品页使用 App Detail,公开榜单链接使用 Rankings,已知应用链接的公开反馈使用 App Reviews。

可以获取哪些 Apple App Store 数据?

当前接口以通用应用结果结构保留公开商品页字段,未提供的值保持为空。

应用标识

获取可用 app ID、名称、开发者、分类、来源 URL 和描述文本。

可见商品页信号

将可用评分、评价数量、价格、榜单位置和发布时间作为特定时间点的值保存。

媒体与观察时间

将可用商品页媒体与 collected_at 一同保存,保留记录的观察上下文。

Apple App Store API 契约概览

三个接口都使用已知公开 URL,并通过标准异步任务结果读取器返回数据。

Endpoint输入来源范围
App Detail一个或多个商品页 URL每个输入 URL 最多一条标准化应用记录
Rankings分类或榜单 URL 及可选 results_limit提交榜单中公开的应用
App Reviews应用 URL 及可选 results_limit提交应用的公开评价

Apple App Store API 如何工作

三个接口都使用标准异步任务流程。

  1. 1. 提交已知商品页 URL

    选择对应接口,POST 必需的 urls 数组和可选结果上限,并保存 task_id。

  2. 2. 跟踪任务

    轮询 /v1/tasks/{task_id},直到任务成功或失败。

  3. 3. 读取已存储记录

    读取 data.results.items;仅当 has_more 为 true 时继续使用 next_cursor。

获取公开应用商品页元数据

使用 SocQ API key 鉴权,并提交一个或多个已知 Apple App Store 商品页 URL。

curl -X POST "https://api.socq.ai/v1/apple-app-store/app-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items

Apple App Store API 常见用途

应用目录补全

为已知应用记录补充标准化标识、介绍信息、开发者、分类、价格、媒体和来源上下文。

商品页比较

在准备好的 URL 集合中比较可用元数据、可见评分、评价数量和价格。

快照监测

将重复结果与 collected_at 一同保存,比较公开商品页字段随时间的变化。

限制与公开数据政策

Apple App Store 结果是特定时间点的公开商品页记录,不提供发布或账号管理功能。

  • 每个输入 URL 都必须解析到 apps.apple.com 或其子域名。
  • 接口接受已知商店 URL,不接受关键词或单独 bundle ID。
  • App Detail 每个 URL 最多保存一条结果;Rankings 和 App Reviews 接受 1 到 2,000 的任务级 results_limit。
  • 任务结果 cursor 只对 SocQ 已存储记录分页。
  • 最终按每条已存结果 0.15 积分结算且空结果基础费用为 0;预估方式取决于所选接口。

Apple App Store API 常见问题

Apple App Store API 是什么?

Apple App Store API 用于通过已知商店链接获取应用详情、采集分类榜单以及采集公开应用评价。

可以按关键词搜索应用吗?

不可以。当前请求从已知 Apple App Store 商品页或榜单链接组成的非空 urls 数组开始。

来源端支持分页吗?

没有调用方可控的来源 cursor;任务结果 cursor 只对采集后已存储的记录分页。

采集如何计费?

每条已存结果为 0.15 积分,最终按实际结果数结算;预估方式取决于所选接口。

将不同平台的公开账号、内容与互动数据统一起来,帮助你持续跟踪品牌、达人和话题表现,更高效地完成跨平台监测与分析。