App Store and Google Play Top Charts

按国家查看 App Store 排行榜：iOS 免费榜、付费榜和畅销榜排名（JSON）

读取任意店面中的 Apple iOS App Store 排行榜：iPhone 和 iPad 的免费榜、付费榜和畅销榜，以及刚刚上架的应用（new、new-free、new-paid），支持总榜或 24 个类别中的任意一个。每一行都包含排名、应用 ID、Bundle ID、开发者、价格、类别和发布日期，以及与上次运行相比的排名变化。无需 Apple 开发者帐户，也无需 Apple 提供的 API 密钥。

本仓库是 Apify 上托管的 App Store Top Charts Scraper 的快速入门指南：从命令行发起一次 HTTP 调用、使用仅依赖 Python 标准库的脚本写入 CSV，以及将其用作 Claude、ChatGPT 或 Cursor 中工具的设置方法。Android 版本请参阅姊妹仓库 google-play-top-charts-api。

• 快速入门：一条 curl 命令
• 快速入门：Python
• 从 AI Agent 使用（MCP）
• 输入 · 输出
• 跟踪排名变化
• 常见问题

快速入门：一条 curl 命令

在 console.apify.com/settings/integrations 获取免费的 Apify API 令牌，然后：

export APIFY_TOKEN=apify_api_...
curl -s -X POST \
  -H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
  -d '{"countries": ["us"], "charts": ["top-free", "top-grossing"], "categories": ["all"], "limit": 10}' \
  "https://api.apify.com/v2/acts/glitchbound~app-charts-scraper/run-sync-get-dataset-items"

响应是一个 JSON 数组，每个上榜应用对应一个对象。

快速入门：Python

example.py 仅使用标准库，并将结果写入 CSV：

python3 example.py --country us --chart top-free --chart top-grossing --limit 3
python3 example.py inputs/games-four-markets.json

第一条命令的实际运行结果：

6 chart rows written to charts.csv
  US top-free #1: Vinted: Pre-loved marketplace (Vinted Limited)
  US top-free #2: Muse from Meta (Meta Platforms, Inc.)
  US top-free #3: TikTok Pro - Events (TikTok Ltd.)
  US top-grossing #1: ChatGPT (OpenAI OpCo, LLC)
  US top-grossing #2: YouTube (Google)

从 AI Agent 使用（MCP）

将其添加为 Claude 或 ChatGPT 中的连接器：

https://mcp.apify.com?tools=glitchbound/app-charts-scraper

在 Cursor 或 VS Code 中，将同一地址填入 mcp.json：

{ "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=glitchbound/app-charts-scraper" } } }

首次调用时，系统会提示你登录 Apify 或提供 API 令牌。之后只需调用一次工具，就能询问“日本目前最畅销的游戏有哪些？”

它也已列入官方 MCP Registry，名称为 io.github.danielhagever/app-store-charts， 并与 Google Play 排行榜工具一同发布（server.json）。

输入

字段	用途
countries	两字母店面代码，使用小写：us、gb（不是 uk）、jp、in、il。支持任意 App Store 店面。
charts	top-free、top-paid、top-grossing，以及这三种排行榜的 -ipad 版本，还有 new、new-free、new-paid
categories	all，或 24 个类别之一：games、finance、education、health-fitness、productivity、shopping 等
limit	每个排行榜的应用数量，上限为 100，即 Apple 允许的最大值
includeDetails	为每一行添加星级评分、评分数量、版本、上次更新日期、大小和年龄分级；每个国家额外发起一次请求
trackRankChanges	默认开启：每一行都会显示应用上次被你的帐户读取该排行榜时的排名
maxItems	整次运行的条目数上限

可直接使用的输入位于 inputs/。如果 Apple 拒绝某个店面（例如使用 uk 而非 gb），返回结果会包含一行未计费的错误信息，注明该店面，而不是返回空结果。

输出

每个上榜应用对应一行。上方运行结果中的两条真实记录见 sample-output.json；其中一条记录的简化示例如下：

{
  "rank": 1,
  "country": "US",
  "chart": "top-grossing",
  "category": "all",
  "appId": "6448311069",
  "bundleId": "com.openai.chat",
  "title": "ChatGPT",
  "developer": "OpenAI OpCo, LLC",
  "price": 0,
  "isFree": true,
  "genre": "Productivity",
  "releaseDate": "2023-05-18T00:00:00-07:00",
  "url": "https://apps.apple.com/us/app/chatgpt/id6448311069?uo=2",
  "chartedAt": "2026-10-26T00:57:11Z"
}

appId 是 Apple 的数字 ID，bundleId 是软件包名称；二者在不同运行和店面之间都保持稳定。

跟踪排名变化

排名随时间变化很有参考价值。你可以在 Apify 上安排每日运行（或通过 cron 调用）；从第二次运行开始，每一行还会包含 previousRank、rankChange（正值表示排名上升）、newInChart 和 previousChartedAt。这样一来，数据集就成了排名跟踪器，而不只是一堆需要比对的快照。

常见问题

有官方的 App Store 排行榜 API 吗？ Apple 将排行榜作为公开订阅源（iTunes RSS 排行榜）发布。此工具会原样读取这些订阅源，因此排名来自 Apple，无需密钥或登录。

如何比较不同国家？ 一次运行中传入多个 countries；每个国家、排行榜和类别的组合都会返回在同一个数据集中。

包含 Mac App Store 吗？ 不包含。Apple 提供了格式相同的 Top Free Mac Apps 订阅源，但其 Top Paid 和 Top Grossing Mac 订阅源返回的内容为空，因此这里不包含 Mac，而不是只提供三种排行榜中的一种。

费用是多少？ 按排行榜中的条目收费；无法读取的排行榜条目不收费。你所用套餐的当前费率请见 Actor 页面。

相关内容

• Google Play Top Charts Scraper：Android 排行榜，覆盖 130 个国家，并包含 Trending；可在 google-play-top-charts-api 快速开始。
• App Store & Google Play Scraper：获取一款应用在两个商店中的评分、价格和元数据。
• App Store & Google Play Reviews Scraper：获取一款应用在两个商店中的所有评论。
• ASO Keyword Rank Tracker：查看应用在两个商店中针对某个关键词的排名。
• 文章：App Store 排行榜 API：Apple 按国家/地区提供的免费排行榜订阅源，以及五个陷阱。

有问题，或发现排行榜有误？请在这里或 Actor 页面提交问题。

许可证

MIT