appstore-reviews

Apple App Store Reviews API：iOS および macOS アプリのレビューを構造化 JSON で取得

Apple App Store Reviews API を利用する、最も効率的で信頼性が高く、開発者に使いやすい方法です。

Actor ページ： apify.com/johnvc/apple-app-store-reviews-api 入力スキーマ： apify.com/johnvc/apple-app-store-reviews-api/input-schema

Apple App Store Reviews API は、あらゆる iOS または macOS アプリのユーザーレビューを、星評価、レビュータイトル、本文、投稿者、アプリのバージョン、レビューの日付、役立ち度のカウントを含む、整理された構造化 JSON として返します。50 か国以上のストアに対応しています。数値の App Store ID、またはアプリ名で対象を指定し、最新順、役立ち度順、高評価順、低評価順に並べ替えられます。また、必要な数だけレビューをページ分割して取得できます。App Store Optimization（ASO）、センチメント分析、競合モニタリング、解約シグナルの追跡、AI エージェントのワークフロー向けに構築されています。

動画での解説

クイックスタート

前提条件

• Python 3.11 以降
• Apify アカウントと API キー（こちらから無料キーを取得）

1. リポジトリをクローンする

   git clone https://github.com/johnisanerd/Apify-Apple-App-Store-Reviews-API.git
   cd Apify-Apple-App-Store-Reviews-API
   

2. UV を使って依存関係をインストールする

   # Install UV if you do not have it:
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Install project dependencies:
   uv sync
   

3. API キーを設定する

   cp .env.example .env
   # Edit .env and add your Apify API key
   # Get your free API key at: https://apify.com?fpr=9n7kx3
   

4. サンプルを実行する

   uv run python apple-app-store-reviews-api-example.py
   

代替方法：API キーを直接設定する

export APIFY_API_TOKEN="your_api_key_here"
uv run python apple-app-store-reviews-api-example.py

この Apple App Store Reviews API を使う理由

分析しやすい、レビューごとに 1 行のデータ。 各結果は、評価、タイトル、本文、投稿者、バージョン、日付があらかじめ分割されたフラットな JSON オブジェクトです。HTML も解析もデータの整理も必要ありません。

ID または名前で対象を指定。 数値の App Store ID が分かる場合はそれを渡し、分からない場合はアプリ名をそのまま渡せば、API が解決します。エージェントがアプリ名しか知らない場合に便利です。

iOS と macOS に対応。 同じ呼び出しで、iPhone、iPad、Mac のアプリを取得できます。各行にプラットフォームが付与されるため、複数のプラットフォームをまとめて取得しても区別できます。

必要な方法で並べ替え。 モニタリングには最新順、優先対応には低評価順、ユーザー自身が支持したシグナルには役立ち度順、お客様の声には高評価順を使えます。

ローカライズに対応。 50 か国以上のストアからレビューを取得できるため、地域ごとのセンチメント比較やローカライズの QA に活用できます。

予測しやすいイベントごとの従量課金。 少額のセットアップ料金に加えてレビューごとの料金がかかるため、簡単なスポットチェックなら数セントで済み、取得した分だけ支払えます。

機能

主な機能

• 数値 ID またはアプリ名を指定して、あらゆる iOS または macOS アプリのレビューを取得
• 最新順、役立ち度順、高評価順、低評価順の 4 種類の並べ替え
• 50 か国以上のストアに対応
• アプリごとのレビュー上限を設定したページ分割、または上限なしで取得
• ISO 日付への正規化と、役立ち度カウントの解析に対応（いずれも任意）

データ品質

• 一貫したフィールド名を使った、レビューごとに 1 行のフラットな JSON
• 各行に、取得元のアプリ ID、国、プラットフォーム、並べ替え順を含む
• 役立ち度を示す文章を解析し、役立った数と合計数を整数で記録
• ロケール形式の日付と、任意の ISO 8601 フィールド

使用例

基本的な例

{
  "product_ids": ["534220544"],
  "max_reviews": 10
}

高度な例

{
  "app_name": "spotify",
  "country": "gb",
  "sort": "mostcritical",
  "max_reviews": 100,
  "start_page": 1,
  "include_macos": true,
  "normalize_dates": true,
  "parse_helpfulness": true
}

入力パラメーター

パラメーター	型	必須	デフォルト	説明
product_ids	array[str]	いずれか	[]	数値形式のApple App Store ID（例：["534220544"]）。apps.apple.com/.../id<NNNNNNNN> URLのidの後ろにある各IDを確認してください。
app_name	str	いずれか	-	アプリ名（例：netflix）。product_idsが空の場合、APIがIDを解決し、最上位の一致結果を使用します。
country	str	いいえ	us	2文字のApple国別ストアコードです。ストアフロントとレビューのロケールを決定します。50か国以上に対応しています。
sort	str	いいえ	mostrecent	mostrecent、mosthelpful、mostfavorable、またはmostcriticalです。iOSのみ対応。macOSでは常に最新のレビューが返されます。
max_reviews	int	いいえ	100	アプリごとの最大レビュー数です。無制限にするには0を設定します（安全のため内部で上限が適用されます）。返されるレビューごとに課金されます。
start_page	int	いいえ	1	ページネーションを開始するページです。再開する場合に便利です。
include_macos	bool	いいえ	true	macOSアプリを完全に除外するにはfalseを設定します。
normalize_dates	bool	いいえ	true	ロケール形式の日付に加えて、review_date_isoフィールドを出力します。
parse_helpfulness	bool	いいえ	true	有用性テキストからhelpful_countとtotal_helpful_countの整数を解析します。

product_idsまたはapp_nameの少なくとも一方が必要です。

出力形式

各データセット項目は1件のレビューです。

{
  "position_global": 1,
  "position_on_page": 1,
  "review_id": "7417861364",
  "review_title": "Lacks ratios",
  "review_text": "Beautiful app with images and videos but doesn't tell you how much of what goes in making the drink. Needs ratios!",
  "rating": 3,
  "review_date": "Jun 02, 2021",
  "review_date_iso": "2021-06-02",
  "reviewed_version": "Version 3.4.2",
  "helpfulness_text": "3 out of 5 customers found this review helpful",
  "helpful_count": 3,
  "total_helpful_count": 5,
  "author_name": "Punkiepollo",
  "author_id": "100937133",
  "product_id": "534220544",
  "app_platform": "ios",
  "app_country": "us",
  "sort_order": "mostrecent",
  "page_number": 1,
  "total_page_count": 8,
  "fetch_timestamp": "2026-05-26T10:30:00+00:00"
}

---

MCP ツールとして使用する

Apple App Store Reviews APIをMCP ツールとして読み込み、アシスタントに呼び出させることができます。MCP サーバーのURLには、このActorのみが事前に読み込まれています。

https://mcp.apify.com/?tools=actors,docs,johnvc/apple-app-store-reviews-api

ブラウザーに表示されたらOAuthで認証するか、Apify APIトークン（Pythonの例で使用しているAPIFY_API_TOKENと同じもの）で認証してください。トークンはhttps://console.apify.com/settings/integrations で取得できます。無料のApifyアカウントはhttps://apify.com?fpr=9n7kx3 で作成できます。

Claude Cowork Desktopにインストールする

Coworkはデスクトップアプリの自動化モードです。Apple App Store Reviews APIをツールとして使えるようにするには、Apify MCP サーバーをコネクターとして追加します。

1. Claudeデスクトップアプリを開き、設定 → コネクターに移動します（または設定 → 開発者 → 設定を編集からclaude_desktop_config.jsonを直接編集します）。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. このActorのみを事前に読み込んだApify MCP サーバーを追加します。

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/apple-app-store-reviews-api"
      ]
    }
  }
}

3. アプリを再起動します。Coworkが初めてツールを呼び出すときは、ブラウザーでOAuthプロンプトを完了するか、コネクター設定にApify APIトークンを追加してOAuthを省略します。
4. Coworkのチャットでツールが利用可能であることを確認し、Apple App Store Reviews APIの実行を依頼します。

デスクトップアプリをダウンロードして、無料トライアルを開始してください：https://claude.ai/referral/uIlpa7nPLg 詳細はこちら：https://docs.apify.com/platform/integrations/claude-desktop

Claude Codeにインストールする

Claude Codeはコマンドラインツールです。次のコマンドでActorのMCP サーバーを追加します。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/apple-app-store-reviews-api"

ブラウザーOAuthの代わりにトークンを使用するには、次のようにします。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/apple-app-store-reviews-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

その後、claude mcp listで確認するか、セッション内で/mcpを実行します。Claude CodeにApple App Store Reviews APIを呼び出すよう依頼してください。

Claude Codeを無料でお試しください：https://claude.ai/referral/uIlpa7nPLg Claude CodeのMCPドキュメント：https://code.claude.com/docs/en/mcp

Claude（ウェブサイト）にインストールする

claude.ai では、Apify をコネクターとして追加し、この Actor のツールだけを有効にします。

1. Settings → Connectors → Browse connectors に移動し、Apify MCP server を検索します。インストールします（求められた場合は有効化または更新します）。
2. 接続時に Apify API トークンで認証し、ツール johnvc/apple-app-store-reviews-api を有効にします。
3. 任意のチャットで + → Connectors を開き、Apify をオンにします。
4. または、Add custom connector を選択して、完全な MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/apple-app-store-reviews-api を貼り付け、求められたら OAuth を使用します。
5. Claude に Apple App Store Reviews API を実行するよう依頼します。

ウェブで Claude を開く：https://claude.ai/referral/uIlpa7nPLg

Cursor にインストールする

Cursor は、プロジェクトファイル .cursor/mcp.json から MCP サーバーを読み込みます。

1. プロジェクト内に .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/apple-app-store-reviews-api"
    }
  }
}

2. ブラウザー OAuth ではなくトークン認証を使用する場合は、ヘッダーを追加します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/apple-app-store-reviews-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → Settings → MCP を開き、apify サーバーが接続されていること（緑色の点）を確認します。
4. Composer または Chat で、Apple App Store Reviews API を呼び出すよう Cursor に依頼します。

Cursor を初めて使いますか？こちらから入手できます：https://cursor.com/referral?code=XQP4VBLI3NNX

ChatGPT にインストールする

ChatGPT は、Developer mode を通じて Apify MCP サーバーに接続します（ChatGPT Pro、Plus、Business、Enterprise、Education プランで利用できます）。

1. プロフィールアイコンをクリックし、Settings > Apps に移動します。Create app ボタンが表示されない場合は、Advanced settings を開いて Developer mode を有効にします。
2. Create app をクリックし、フォームに入力します。
   • Name： Apify
   • MCP Server URL： https://mcp.apify.com/?tools=actors,docs,johnvc/apple-app-store-reviews-api
   • Authentication： OAuth
3. Create をクリックし、Apify との接続を認証します。
4. 会話でアプリを使用するには、チャットで + をクリックし、Developer mode を選択して、Apify を選びます。

詳細：https://docs.apify.com/platform/integrations/mcp

---

心を込めて作成

Apple App Store Reviews API を活用して、信頼性の高い構造化された結果で ASO、センチメント分析、競合モニタリングを実現しましょう。

最終更新日：2026.06.15

n8n との統合

n8n コミュニティノード n8n-nodes-apple-app-store-api として利用できます。n8n で、Settings、Community Nodes の順に開き、n8n-nodes-apple-app-store-api をインストールして、任意のワークフローで使用します（AI エージェントのツールとしても機能します）。このノードには、この Actor と Apple App Store Search API および Product API がまとめられており、1 つの Apify 認証情報で 3 つの操作を利用できます。

注目のタスク

Apify Store ですぐに実行できるサンプルです。

• App Store レビューを CSV にエクスポート

🤖 この Actor について AI アシスタントに質問する

Apple App Store Reviews API に関するすぐに送信できるプロンプトを、お好みの AI で開きます。

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

最終更新日：2026.10.27