应用数据 API 概览

应用数据 API 用于获取移动应用的结构化数据，可覆盖应用排名、评分、评论、被哪些应用专题/榜单收录等信息。该接口适合用于产品规划、评论管理自动化、竞品研究与市场分析。

目前本接口支持两大主流移动应用平台的数据采集：

• 使用 /v3/app_data/google/overview/ 可获取 Google Play 上发布应用的数据
• 使用 /v3/app_data/apple/overview/ 可获取 App Store 中应用的数据

后续还会持续扩展更多数据源。

返回结果会严格受以下参数影响：

• 搜索引擎/数据源类型（Google 或 Apple）
• 语言
• 地区

本平台会尽可能高精度模拟指定地区与对应平台环境，因此返回结果通常能够贴近任务提交时该参数组合下的真实页面结果。

功能说明

应用数据 API 提供两类标准功能：Advanced 与 HTML。

Advanced 功能

Advanced 用于返回结构化结果，适合基于以下条件获取完整数据：

• 应用 ID
• 应用专题/集合分类
• 语言
• 地区

适用于需要直接处理字段化结果的业务场景，如排名分析、评分监控、评论处理和竞品比对。

HTML 功能

HTML 用于返回原始 HTML 页面，适用于以下维度：

• 应用名称或应用标识符
• 语言
• 地区

适合需要自行解析页面或保留原始页面快的场景。

注意：HTML 端点在 Google 应用数据接口中支持。

调用方式

应用数据 API 支持 Standard 标准任务模式。该模式需要分两步调用：

1. 通过 POST 创建任务 2.平台采集完成后，通过 GET 获取结果

也可以在创建任务时指定以下回调字段：

• pingback_url：任务完成后通知你的系统
• postback_url：任务完成后直接将结果推送到你的系统

如果使用 postback_url，还需要额外指定用于结果返回的功能类型：

• advanced
• html

如果未设置 pingback_url 或 postback_url，可以通过 Tasks Ready 端点获取所有已完成但尚未获取结果的任务 ID 列表，然后再通过 Task GET 端点逐个获取结果。

任务结果获取流程

标准推荐流程如下：

1. 调用对应 POST 端点创建任务
2. 等任务执行完成
3. 通过 Tasks Ready 查询已完成任务
4. 使用 Task GET 获取结果

这种方式适合批量任务管理、异步采集和数据库流程。

请求频率限制

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

• POST + GET 合计最多 2000 次/分钟
• 每次 POST 请求中最多 100 个任务

如需提升限额，可联系平台支持。

优级与计费

应用数据 API 的费用取决于任务执行优级。

Standard 模式支持两种优级：

1. normal：普通优级
2. high：高优级

不同优级对应不同执行速度与价格。

实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

你也可以通过用户数据接口查看账户余额、消耗和额信息。

沙箱测试

在正式接前，可通过沙箱环境验证请求结构、字段格式和任务处理流程，以降低联调成本。

接口路径

以下为应用数据 API 的主要路径：

• /v3/app_data/google/overview/
• /v3/app_data/apple/overview/

子端点通常会按平台、功能类型和任务方式进一步细分，例如：

• 任务提交（POST）
• 任务结果获取（GET）
• 已完成任务列表（Tasks Ready）

接时请根据数据目标选择对应平台与功能端点。

认证方式

所有请求均应在请求头中携带 API 密钥：

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

请求示例

curl 创建任务示例

curl -X POST "https://api.seermartech.cn/v3/app_data/google/..." \
 -H "Authorization: Bearer smt_live_YOUR_KEY" \
 -H "Content-Type: application/json" \
 -d '[
 {
 "language_name": "English",
 "location_name": "United States",
 "app_id": "com.example.app",
 "priority": 1
 }
 ]'

Python 创建任务示例

import requests

url = "https://api.seermartech.cn/v3/app_data/google/..."
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
payload = [
 {
 "language_name": "English",
 "location_name": "United States",
 "app_id": "com.example.app",
 "priority": 1
 }
]

resp = requests.post(url, headers=headers, json=payload)
print(resp.status_code)
print(resp.json)

TypeScript 创建任务示例

const response = await fetch("https://api.seermartech.cn/v3/app_data/google/...", {
 method: "POST",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 body: JSON.stringify([
 {
 language_name: "English",
 location_name: "United States",
 app_id: "com.example.app",
 priority: 1
 }
 ])
});

const data = await response.json;
console.log(data);

型请求体字段

以下字段是应用数据任务中常见的参数，支持以对应子端点文档为准：

字段	类型	说明
app_id	string	应用唯一标识符
keyword	string	查询，适用于搜索类接口
language_name	string	目标语言
location_name	string	目标地区
priority	integer/string	任务优级，通常为普通或高优级
pingback_url	string	任务完成通知地址
postback_url	string	结果回传地址
postback_data	string	指定回传结果类型，通常需与 advanced 或 html 对应

返回结果说明

返回结果通常以下几类信息：

字段	说明
id	任务 ID
status_code	状态码
status_message	状态说明
cost	本次任务扣费
result_count	返回结果数量
path	当前请求路径
data	请求参数回显
result	任务结果

对于 Advanced 任务，result 一般为结构化字段数据；对于 HTML 任务，result 中通常原始页面源码或页面。

错误处理建议

调用时建议重点检查以下：

• status_code 是否为成功状态
• status_message 是否参数或权限异常信息
• cost 是否符合预期
• result 是否为空
• 地区、语言、应用 ID 或是否填写正确

常见错误通常：

问题类型	说明
认证失败	API Key 无效、缺失或权限不足
参数错误	语言、地区、应用标识符或功能参数不合法
任务未完成	调用 GET 时任务尚未处理完毕
出频控	过每分钟请求次数或单次 POST 任务数限制

使用建议

• 需要结构化结果时，优使用 Advanced
• 需要页面原始时，使用 HTML（限 Google）
• 批量任务建议通过异步模式统一提交，再通过 Tasks Ready 集中拉取
• 大规模采集时建议 pingback_url 或 postback_url，降低轮询成本
• 上线前在沙箱环境验证字段与回调逻辑

实用场景

• 监控应用排名：持续跟踪指定应用在不同国家、语言和平台下的搜索排名变化，帮助评估 ASO 策略效果。
• 分析竞品评分与评论：批量采集竞品应用的评分和用户评论，识别产品短板与用户点，反向指导版本迭代。
• 发现专题机会：查看应用被哪些榜单、分类或专题收录，评估流量与分发渠道价值。
• 自动化处理评论运营：定期抓取新增评论并同步到工单或客服系统，提高评论响应效率与口碑管理能力。
• 评估区域化市场表现：按国家和语言维度对比应用在不同市场的可见度与反馈差异，为本地化投放和产品优化提供依据。