输入 App 和国家/地区,返回该 App 在 App Store 的用户评分与评论
App Store 榜单
输入国家和榜单类型,返回 App Store 免费榜、付费榜、畅销榜的排名,带评分、评分数、当前版本和最近更新日期
概览
从苹果官方榜单获取 App Store 的免费榜、付费榜和畅销榜,覆盖近百个国家和地区,可以按分类看,比如游戏、效率、社交,或者「策略」「角色扮演」这样的游戏子分类。一次可以同时看多个国家、多个榜单。
每个上榜的 App 除了排名,还会带上它在当地的评分、评分人数、当前版本、最近更新日期、开发者、价格和包名,不用再一个个打开 App 页面查。适合出海 App 和游戏团队盯竞品、看各个市场哪些产品在涨、找可以对标的产品。
结果里的 App ID 和国家/地区,可以直接交给「App Store 评论」应用,拉取这些 App 在当地的用户评论。
数据说明
- 数据来自苹果官方榜单。每个榜单只有前 100 名,这是苹果公开的全部名次。
- 只返回运行时的当前榜单,没有历史排名。想看名次变化,可以每天运行一次,按「行编号」和「取数时间」对比。
- 评分、评分人数都是这个 App 在该国家/地区的数据,同一个 App 在不同国家的评分不同。苹果不公开下载量和收入金额。
- 有的国家没有某些分类的榜单,比如中国大陆没有「新闻」分类。遇到这种情况会单独返回一行说明,不会漏掉。
结果示例
| 国家/地区 | 榜单 | 分类 | 排名 | App ID | App 名称 | 评分 | 评分数 | 当前版本 | 最近更新日期 |
|---|---|---|---|---|---|---|---|---|---|
| cn | 畅销榜 | 游戏 | 1 | 989673964 | 王者荣耀 | 3.25 | 15113555 | 12.1.1.1 | 2026-09-22 |
| cn | 畅销榜 | 游戏 | 2 | 1642894547 | 三角洲行动 | 4.57 | 3849158 | 1.201.37119 | 2026-11-04 |
| cn | 畅销榜 | 游戏 | 3 | 1478101301 | 金铲铲之战 | 4.63 | 8663952 | 1.14.35(1188) | 2026-09-28 |
应用场景
- 出海选市场:对比美国、日本、韩国、东南亚等市场的畅销榜,看哪类游戏和 App 在当地赚钱。
- 竞品监测:每天跑一次目标市场的榜单,跟踪竞品的名次、评分和更新节奏。
- 找对标产品:按分类看榜单,挑出评分高、最近还在频繁更新的产品作为参考。
- 榜单加评论:先用本应用找到目标 App,再用「App Store 评论」拉取它们在当地的用户评论,分析用户喜欢什么、抱怨什么。
适用边界
数据来自苹果官方榜单,每个榜单最多前 100 名(苹果只公开这么多);单次最多 30 个榜单(国家 × 榜单 × 分类),超过时运行直接报错、不收费;只有当前榜单,没有历史排名;不含 Google Play。按返回的榜单位置计费,取不到的榜单不计费
- 适合用于
- 看某几个国家/地区的免费榜、付费榜、畅销榜,了解当地最受欢迎或最赚钱的 App 和游戏
- 出海团队盯竞品:每天跑一次,按 row_id 和取数时间对比名次变化
- 找对标 App:按分类(如「游戏-策略」)看榜单,同时拿到评分、评分数、最近更新日期
- 先查榜单,再把结果里的 app_id 和 country 交给「App Store 评论」(data_hunter/app-store-reviews,应用 ID app_ac5a31d324f0)拉取用户评论
- 不要用于
- 需要历史排名或排名走势:本应用只返回当前榜单,需要自己每天运行并保存
- 需要 100 名以后的排名:苹果只公开前 100 名
- 需要安卓应用或 Google Play 榜单
- 需要下载量、收入金额:苹果不公开这些数字
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1每个请求的榜单都有结果:苹果没有公布的榜单(如中国大陆的「新闻」分类)返回一行「这个榜单没有内容」,不计费
- 2「暂时失败,可稍后重试」表示 App Store 暂时无法访问,可原样重试;全部榜单都失败时运行失败并标记为可重试
- 3个别 App 缺少评分、版本等详情时,排名照常返回,状态说明里会写明原因
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 国家/地区
countries选填array<string>看哪些国家/地区的 App Store 榜单,同一个榜单在不同国家完全不同,最多 10 个。不填默认中国大陆。国家清单与「App Store 评论」应用一致。数量最多 10 项 - 榜单
charts选填array<string>要看的榜单,可多选:免费榜、付费榜、畅销榜(按收入排名)。国家数 × 榜单数 × 分类数不能超过 30,超过时运行直接报错、不收费。不填默认免费榜。数量最多 3 项 - 设备
device选填string(enum)iPhone 榜单还是 iPad 榜单,两者排名不同。不填默认 iPhone。可选值iPhoneiphoneiPadipad默认值iphone - 分类
categories选填array<string>按 App Store 分类看榜单,最多 5 个;「游戏-」开头的是游戏子分类。不填则看总榜(全部分类)。数量最多 5 项 - 每个榜单取前几名
top_n选填integer每个榜单返回前多少名,1–100。苹果只公开每个榜单的前 100 名。范围1–100默认值100
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 行编号
row_idstring国家-设备-榜单-分类编号-排名,同一天重复运行时同一个位置编号相同;说明问题的行排名部分为 none示例us-iphone-top_grossing-6014-1 - 国家/地区
countrystringApp Store 国家/地区代码;与 app_id 一起可直接作为「App Store 评论」(data_hunter/app-store-reviews)的 countries 输入示例us - 设备
devicestringiphone 或 ipad示例iphone - 榜单代码
chartstringtop_free(免费榜)、top_paid(付费榜)、top_grossing(畅销榜)示例top_grossing
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"row_id": "us-iphone-top_grossing-6014-1",
"country": "us",
"device": "iphone",
"chart": "top_grossing",
"chart_name": "畅销榜",
"category": "游戏",
"rank": 1,
"app_id": "1621328561",
"app_name": "MONOPOLY GO!",
"developer": "Scopely, Inc.",
"price": 0,
"currency": "USD",
"primary_genre": "Games",
"genres": "Games / Family / Board / Entertainment",
"rating": 4.8,
"rating_count": 3882124,
"version": "1.80.5",
"updated_at": "2026-11-03",
"released_at": "2023-04-11",
"bundle_id": "com.scopely.monopolygo",
"size_mb": 299.8,
"content_rating": "9+",
"app_url": "https://apps.apple.com/us/app/monopoly-go/id1621328561",
"icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/a0/62/29/a06229c3-a052-7b77-3847-ec54b803db1d/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/512x512bb.jpg",
"fetched_at": "2026-11-05T01:41:45Z",
"status": "ok",
"status_text": "已返回",
"billed_rows": 1
}调用方式
本 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=data_hunter/app-store-charts",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按输出字段 billed_rows 求和计量,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。