应用数据 API：概览

应用数据 API 用于获取移动应用市场的结构化数据应用排名、评分、评论、应用合集收录等。该接口适合用于产品路线规划、评论自动化管理、竞品研究与应用市场分析。

本平台当前支持以下两类移动应用商店数据源：

• Google 应用数据：通过 /v3/app_data/google/overview/ 下的接口获取 Google Play 中已发布应用的数据。
• Apple 应用数据：通过 /v3/app_data/apple/overview/ 下的接口获取 App Store 中应用的数据。

返回结果与指定的搜索引擎、语言和地理位置。本平台会按任务中设置的地区及搜索引擎环境模拟查询，以尽可能匹任务创建时对应条件下的结果。

未来将持续扩展更多应用市场数据源。

数据获取功能

应用数据 API 提供以下两种数据获取功能：

功能	说明
advanced	返回完整的结构化应用数据，可基于、应用 ID 或应用合集分类查询，并支持指定语言和地区。
html	返回指定应用名称或应用标识符在指定语言和地区下的原始 HTML 页面。

> 注意：html 功能适用于 Google 应用数据接口。

数据获取方式

应用数据 API 支持标准任务模式（Standard）。使用该模式时，需要分别发起创建任务的 POST 请求和获取结果的 GET 请求。

基本流程如下：

1. 调用对应的任务创建接口，提交一个或多个查询任务。
2. 等平台完成数据采集。
3. 调用任务结果接口，按任务 ID 获取结果。

创建任务时，还可以以下回调字段：

字段	说明
pingback_url	任务完成后，本平台向该地址发送完成通知。通知中通常任务标识，您可再调用结果接口获取数据。
postback_url	任务完成后，本平台将结果直接推送至该地址。使用该字段时，同时指定数据获取功能，即 advanced 或 html。

如果未设置 pingback_url 或 postback_url，可按以下方式轮询获取结果：

1. 调用 Tasks Ready 接口，获取已完成但尚未提取结果的任务 ID 列表。
2. 使用任务 ID 调用 Task GET 接口获取对应结果。

调用限制

应用数据 API 的调用频率限制如下：

限制项	上限
POST 与 GET 请求总量	每分钟最多 2,000 次
单个 POST 请求中的任务数	最多 100 个任务

如需提高调用限额，请联系技术支持。

任务优级与计费

标准任务模式支持两种执行优级。优级决定任务处理速度，并影响接口计费：

优级	说明
normal	普通优级，适合对时效要求一般的批量采集任务。
high	高优级，适合需要更快获得结果的业务场景。

不同端点、数据源、任务类型及优级的计费可能不同。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

您可通过用户数据接口查询账户消耗与余额信息，也可使用 Sandbox 环境进行接口联调和功能测试。

型任务处理流程

以下为标准任务模式的通用处理逻辑：

创建任务（POST）
    ↓
任务完成
    ↓
通过 pingback_url / postback_url 接收通知或结果
    ↓
或调用 Tasks Ready 获取已完成任务 ID
    ↓
调用 Task GET 获取任务结果

使用 postback_url 时，应在创建任务参数中明确指定结果类型：

[
  {
    "postback_url": "https://your-domain.example.com/app-data/callback",
    "function": "advanced"
  }
]

：

• function: "advanced"：推送结构化结果。
• function: "html"：推送原始 HTML 结果适用于 Google 应用数据接口。

实用场景

• 监控竞品应用排名变化：按国家、语言和持续采集应用排名，识别竞品的自然增长、投放活动或版本更新影响。
• 分析用户评论与评分趋势：获取应用评分和评论数据，定位高频负面反馈，为产品迭代和客服响应提供依据。
• 跟踪应用商店精选与合集收录：监测应用是否特定分类、榜单或编辑精选合集，评估品牌和商店运营效果。
• 调研目标市场应用生态：按不同地区和语言查询同类应用，识别区域市场中的热门产品、功能定位及本地化机会。
• 构建应用舆预警系统：结合定时任务和回调通知，在评分下降或负面评论增加时及时触发运营告警。