App Store 榜单排名采集
按国家与分类抓 App Store 的免费榜、付费榜、畅销榜,返回每个应用的排名、评分、价格、开发者与所属分类
概览
把某个国家某个分类下的 App Store 榜单摊成一张表:现在排第几、叫什么、谁做的、评分多少、卖多少钱。做竞品监测、品类调研、或者只是想确认「这个赛道上现在谁在前面」,不用再一个个国家手翻榜单。
同一批应用在不同国家的排名、价格、评分差别很大,同一张榜里又混着免费应用和付费应用。这里一行就是一个应用在一张榜上的一个名次,「榜单类型」区分免费榜、付费榜、畅销榜,「榜单分类」记下这是哪张榜,「应用所属分类」是苹果给这个应用自己标的分类——两者不一样是正常的,游戏也会出现在总榜里。
数据说明
榜单来自苹果应用商店对外公开的排名,覆盖 150 多个国家或地区,包含免费榜、付费榜、畅销榜三种,以及总榜和游戏、财务、娱乐、购物、教育等二十多个分类。只覆盖苹果 App Store,不含安卓的 Google Play。
排名是抓取那一刻的名次,是一个时点快照,不是历史曲线。榜单条数有限,苹果对每个榜单最多只公开前 100 名,取不到的部分不代表没有应用。
「评分」和「评分数量」是该市场的用户打分,不是全球汇总:同一个应用在美国是 4.8 分、在日本可能只有 4.2 分,跨国比评分前先确认这一点。评分人数很少时容易出现 5 分,用「评分数量」一起看才准。
「价格」是当地货币的当前售价,免费应用为 0,币种见「币种」;「价格原文」保留商店页面上的原样写法(获取、免费、$6.99、¥1,980),方便人工核对。「畅销榜」按收入口径排,免费应用靠内购也能上榜,所以畅销榜里出现 0 元价格是正常的。
这里不给下载量、收入估算和历史排名,这些苹果不公开,任何声称能给的都来自第三方估算,本应用不做推算,也不拿空值冒充。
结果长什么样
每行是一个应用在某张榜上的一个名次。
| 排名 | 应用名 | 开发者 | 评分 | 评分数量 | 价格 |
|---|---|---|---|---|---|
| 1 | Kalshi: Trade Sports & Events | KalshiEX LLC | 4.82 | 701976 | 0 |
| 2 | Capital One Mobile | Capital One | 4.86 | 4133502 | 0 |
| 3 | PayPal - Pay, Send, Save | PayPal, Inc. | 4.71 | 10590832 | 0 |
此外还有榜单类型、榜单分类、应用所属分类、应用编号、包名、图标链接、应用页面链接、上架日期、采集时间等字段。
应用场景
- 竞品监测:按「榜单分类」筛出自己所在的赛道,看前 20 名都是谁、评分多少;隔一段时间用同样条件重跑,按「记录编号」对齐两次结果,就能看出谁在往上爬、谁掉出去了。
- 品类格局:把免费榜和畅销榜一起抓,按「应用名」对上号——下载多但不赚钱的、赚钱但量不大的,两类应用的产品形态通常完全不同。
- 跨国发行判断:同一个应用在多个市场的排名放在一张表里比,判断该先打哪个市场;价格和评分的差异也一并能看到。
适用边界
只覆盖苹果 App Store(iPhone 与 iPad 共用榜单),不含 Google Play;单次最多 20 个国家、20 个分类、3 种榜单,写回上限 2 万条
- 适合用于
- 要盯某个国家某个分类下现在排名前几的是哪些应用,以及它们的评分、价格和开发者
- 做竞品或品类研究,需要把免费榜、付费榜、畅销榜放在一起看,找出既热门又赚钱的应用
- 隔一段时间用同样条件重跑,按「记录编号」对齐两次结果,观察排名和评分的移动
- 不要用于
- 要安卓端 Google Play 的榜单:这里只覆盖苹果 App Store
- 要某个应用的历史排名曲线或下载量、收入估算:这里只给当下这一刻的真实排名,不含历史回看与销量估算
- 要查某个应用的全部用户评论内容:这里只给排名与评分汇总,不给评论正文
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1某个国家与分类的组合没有返回数据时,多半是该分类在这个国家没有榜单,换个分类或国家再试
- 2国家代码要填两位字母,写错会直接报错并提示正确写法
- 3网络临时不通导致失败时,隔几分钟原样重跑即可
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 榜单类型
charts必填array<string>要抓哪几张榜,可以多选。免费榜是下载量最高的免费应用,付费榜是卖得最好的付费应用,畅销榜是收入最高的应用(含免费应用的内购收入)。数量最多 3 项默认值free示例["free","grossing"] - 国家或地区
countries必填array<string>要抓哪些市场的榜单,填两位国家或地区代码,例如 US、CN、JP、GB、HK、TW。一次可以填多个,每个市场单独出一套榜单;同一个应用在不同市场的排名、价格和评分都不一样。数量最多 20 项默认值US示例["US","CN"] - 分类
categories选填array<string>要抓哪些分类的榜单。填 0 是总榜,也可以填分类编号(6014 游戏、6015 财务、6016 娱乐、6024 购物、6017 教育…)或别名(games、finance、entertainment、shopping、travel…)。多个分类各自出一套榜单。数量最多 20 项默认值0示例["0","6014"] - 每张榜取多少名
maxResults选填integer每张榜单往下取多少名,默认 50,最多 100(苹果公开榜单本身最多 100 名)。填得越多耗时越长,写回的总行数是「国家数 × 榜单数 × 分类数 × 这个数」。范围1–100默认值50 - 同时抓总榜
includeOverall选填boolean打开后,除了指定的分类,还会把该国家的总榜一起抓下来,方便对比「这个应用在分类里排第几、在总榜排第几」。默认值false
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 记录编号
rank_keystring由国家、榜单、分类和应用编号拼成,同一应用在同一张榜上恒定不变,可用于跨次运行对齐和去重示例US|free|0|1632713844 - 排名
rankinteger这个应用在该国家该榜单上的名次,1 是第一名示例1 - 榜单类型
chartstringfree 免费榜、paid 付费榜、grossing 畅销榜示例free - 应用编号
app_idstring苹果应用商店里的应用编号,同一应用在各市场通用示例1632713844
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"rank_key": "US|free|0|1632713844",
"rank": 1,
"chart": "free",
"app_id": "1632713844",
"bundle_id": "com.kalshi.mobile",
"name": "Kalshi: Trade Sports & Events",
"os": "ios",
"country": "US",
"chart_category_id": "0",
"chart_category": "总榜",
"app_category": "Finance",
"publisher_name": "KalshiEX LLC",
"publisher_id": "1593463046",
"rating": 4.81959,
"rating_count": 701976,
"price": 0,
"currency": "USD",
"price_display": "Get",
"icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/ac/22/63/ac2263c8-7599-055b-b7be-d0998468e4ff/AppIcon-0-0-1x_U007ephone-0-1-85-220.png/512x512bb.jpg",
"app_url": "https://apps.apple.com/us/app/kalshi-trade-sports-events/id1632713844?uo=4",
"released_at": "2022-09-16",
"collected_at": "2026-11-17T08:36:12+00:00"
}调用方式
本 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=bazhuayu_Beth/app-store-top-charts",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。