概览
App Store 关键词排名采集:输入一组关键词,返回每个关键词在 App Store 搜索结果中的排名应用列表,可限定只追踪指定 App 的排名位置。适合用于 ASO 监控、竞品排名对比和关键词效果追踪。
数据说明
- 数据来源是 Apple 面向公众的应用搜索接口,按接口返回顺序给出排名(与 App Store 搜索排序高度一致,但 Apple 不承诺完全一致)。
- 支持指定国家/地区(美国、中国、日本等 15 个常用区),排名因地区而异,应按目标市场分别查询。
- 输入
app_ids时只返回这些 App 的排名行;某个 App 在该关键词下没有进入搜索结果时不产生记录。留空则返回排名前 N 的应用。 - 单次运行最多 100 个关键词,每个关键词 1 次请求;行数上限为 关键词数 × 前 N 名。
- 不提供 Apple 官方的 Search Popularity 与关键词难度(未公开数据);接口不可用时明确报告失败,不返回空结果冒充成功。
结果示例
| 排名行ID | 关键词 | 地区 | 排名 | App | 开发者 | 评分 | 评分人数 | 分类 | 价格 |
|---|---|---|---|---|---|---|---|---|---|
| us:photo editor:284882215 | photo editor | us | 3 | Meta Platforms, Inc. | 4.5 | 500000 | Photo & Video | 0 | |
| us:photo editor:547702041 | photo editor | us | 7 | Pixel Art | Nest | 4.8 | 12000 | Graphics & Design | 2.99 |
使用场景
- ASO 监控:定时查询核心关键词排名,跟踪自家 App 排名波动。
- 竞品对比:输入同一组关键词,对比自家与竞品的排名位置变化。
- 关键词筛选:批量查询候选关键词的 top 应用构成,评估关键词竞争度。
- 市场区分:按国家/地区分别查询,制定不同市场的 ASO 策略。
适用边界
仅覆盖 Apple App Store 搜索排名(公开 search 接口);不支持 Google Play,也不提供第三方 Search Popularity/难度数据
- 适合用于
- 追踪自家 App 在核心关键词下的搜索排名变化
- 对比竞品在同一关键词下的排名位置
- 不要用于
- 需要 Google Play 关键词排名
- 需要 Apple Search Popularity 或关键词难度等官方未公开指标
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1接口返回非 200 或非 JSON 时视为采集失败并报告,不用空结果冒充成功
- 2追踪的 App 在该关键词下没有排名时不产生该行记录
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 关键词列表
keywords必填array<string>要查询排名的 App Store 搜索关键词,单次最多 100 个。示例["photo editor"] - 国家/地区
country选填string(enum)App Store 国家/地区代码,排名因地区而异。可选值如 us(美国) / cn(中国) / jp(日本) / de(德国) / gb(英国) / fr(法国) / au(澳大利亚) / ca(加拿大) …(共 15 项,试运行表单可搜索)默认值us示例us - 追踪的 App
app_ids选填array<string>可选。只返回这些 App(数字 App ID 或 App Store 链接)在每个关键词下的排名位置;留空则返回该关键词下排名前 N 的应用。示例[] - 前 N 名
top_n选填integer未指定追踪 App 时,每个关键词返回的排名前 N 个应用。范围1–50默认值10示例10
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 排名行ID
rank_idstring由国家/地区、关键词和 App ID 组成的唯一标识,用作去重键。示例us:photo editor:284882215 - 关键词
keywordstring本条排名所属的关键词。示例photo editor - 国家/地区
countrystring本条排名所属的国家/地区代码。示例us - 排名
positioninteger该 App 在该关键词搜索结果中的位置,从 1 开始。示例3
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"rank_id": "us:photo editor:284882215",
"keyword": "photo editor",
"country": "us",
"position": 3,
"app_id": "284882215",
"app_name": "Facebook",
"publisher": "Meta Platforms, Inc.",
"rating": 4.5,
"rating_count": 500000,
"genre": "Photo & Video",
"price": 0
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=Matrix_He/appstore-keyword-rank",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。