App Store and Google Play Top Charts

国別App Storeトップチャート：トップ無料、トップ有料、売上トップのiOSランキングをJSONで取得

任意のストアフロントについて、AppleのiOS App Storeトップチャートを読み取ります。iPhoneとiPadのトップ無料、トップ有料、売上トップに加え、全体チャートまたは24種類のカテゴリから、新着アプリ（new、new-free、new-paid）も取得できます。各行には、順位、アプリID、バンドルID、開発者、価格、ジャンル、リリース日と、前回実行時からの順位変動が含まれます。Appleの開発者アカウントも、AppleのAPIキーも不要です。

このリポジトリは、Apifyでホストされている App Store Top Charts Scraperをすぐに使い始めるためのものです。シェルからのHTTP呼び出し1回、CSVを書き出す標準ライブラリのみを使用したPythonスクリプト、Claude、ChatGPT、Cursorでツールとして使うための設定が含まれています。Android版については、姉妹リポジトリのgoogle-play-top-charts-apiをご覧ください。

• クイックスタート：curlを1回実行
• クイックスタート：Python
• AIエージェントから使用する（MCP）
• 入力 · 出力
• 順位の推移を追跡する
• よくある質問

クイックスタート：curlを1回実行

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配列で、チャートに掲載されているアプリごとに1つのオブジェクトが含まれます。

クイックスタート：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エージェントから使用する（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トークンの入力を求められます。その後は「今、日本で売上トップのゲームは？」と尋ねるだけで、ツールが1回呼び出されます。

Google Playチャートツール（server.json）とともに、公式MCP Registryにも io.github.danielhagever/app-store-charts として登録されています。

入力

フィールド	機能
countries	ストアフロントの小文字2文字のコードです。us、gb（ukではありません）、jp、in、ilなどを指定します。任意のApp Storeストアフロントに対応しています。
charts	top-free、top-paid、top-grossing、これら3種類の-ipad付き、およびnew、new-free、new-paid
categories	all、または24種類のカテゴリのいずれかです。games、finance、education、health-fitness、productivity、shoppingなどがあります。
limit	チャートごとのアプリ数です。Appleの上限である100まで指定できます。
includeDetails	国ごとに追加のリクエストを1回行い、すべての行に星評価、評価数、バージョン、最終更新日、サイズ、年齢制限を追加します。
trackRankChanges	デフォルトで有効です。各行に、アカウントがそのチャートを前回読み取った際のアプリの順位が表示されます。
maxItems	実行全体の上限です。

すぐに使える入力例はinputs/にあります。Appleに拒否されるストアフロント（gbではなくukなど）を指定すると、空の結果ではなく、該当するストアフロント名を示す未課金のエラー行が返されます。

出力

チャートに掲載されているアプリごとに1行が出力されます。上記の実行結果から抜粋した実際の2行はsample-output.jsonにあります。そのうち1行を簡略化したものは次のとおりです。

{
  "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から呼び出す）と、2回目以降の実行では各行にpreviousRank、rankChange（正の値は順位上昇を意味します）、newInChart、previousChartedAtも含まれます。そのため、データセットは差分を取るためのスナップショットの寄せ集めではなく、順位トラッカーとして利用できます。

よくある質問

App Store の公式トップチャート API はありますか？ Apple はトップチャートを公開フィード（iTunes RSS チャート）として公開しています。このツールはそのフィードをそのまま読み取るため、ランキングは Apple 独自のもので、キーもログインも不要です。

国ごとの比較方法を教えてください。 1 回の実行で複数の countries を指定すると、各国、チャート、カテゴリの組み合わせが同じデータセットに返されます。

Mac App Store も含まれますか？ いいえ。Apple は同じ形式で Top Free Mac Apps フィードを提供していますが、Top Paid と Top Grossing の Mac フィードは空で返ってきたため、3 種類のチャートのうち 1 種類だけを提供するのではなく、Mac は対象外としています。

料金はいくらですか？ チャートの行ごとに料金が発生します。読み取れなかったチャートの行には料金がかかりません。ご利用プランの現在の料金はActor ページをご覧ください。

関連情報

• Google Play Top Charts Scraper：Android のチャートに対応し、130 か国とトレンドを掲載しています。google-play-top-charts-apiでクイックスタートをご覧ください。
• App Store & Google Play Scraper：両ストアにおける 1 つのアプリの評価、価格、メタデータを取得します。
• App Store & Google Play Reviews Scraper：両ストアにおける、アプリのすべてのレビューを取得します。
• ASO Keyword Rank Tracker：両ストアで、アプリがキーワードに対してどの順位にランクインしているかを確認できます。
• 解説記事：App Store top charts API: Apple's free chart feeds by country, and five traps。

ご質問や、チャートに誤りがあると思われる場合は、こちらまたは Actor ページで issue を作成してください。

ライセンス

MIT