Apple App Store App Detail API

Apple App Store App Detail

主要特性

• 按已知 URL 批量输入一次提交一个或多个 apps.apple.com 商品页 URL，每个清洗后的 URL 会映射为一条来源输入，并最多保留一条标准化应用记录。
• 应用标识与介绍信息以一致的应用结构返回 app ID、名称、描述文本、开发者、分类、来源 URL 和采集时间。
• 可见评分与价格上下文保留可用评分、评价数量和结构化价格字段，便于比较商品页记录，无需解析页面文本。
• 媒体与目录上下文将可用商品页媒体与发布时间、采集时间一同保存，并省略公开页面未提供的结构字段。

参数

如何使用

提交已知商品页 URL，跟踪异步任务，并从已存储结果页读取标准化应用记录。

1. 准备一个或多个公开 Apple App Store 商品页 URL，其 hostname 必须为 apps.apple.com 或其子域名。
2. 将 urls 数组 POST 到 /v1/apple-app-store/app-detail，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
4. 从 data.results.items 读取应用记录；仅当 has_more 为 true 时继续使用 next_cursor。

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；仅在 has_more 为 true 时继续使用 next_cursor

最佳使用场景

• 应用目录补全： 为已有 App Store 链接的记录补充标准化应用标识、介绍信息、开发者、分类、价格、媒体和来源 URL。
• 商品页对比： 在选定 URL 集合中比较开发者与分类、可见评分、评价数量、价格和介绍文案。
• 元数据快照监测： 将重复采集结果与 collected_at 一同保存，用于识别名称、描述、分类、可见评分、价格和媒体随时间的变化。

使用建议

• 提交前将每个 URL 解析后的 hostname 与 apps.apple.com 比对，并使用商品页 URL，不要提交搜索词、bundle ID 或商店名称。
• 先对 URL 去重，避免重复输入产生多余的来源行或重复应用记录。
• 允许 rating、reviews_count、price、media、published_at、installs 和 rank 为空，因为商品页可能只提供应用结构中的部分字段。
• 不要把 next_cursor 当作 App Store 上游翻页令牌；它只用于读取当前已完成 SocQ 任务中已经存储的结果。

相关 API