Appfigures

@appfigures/cli

Appfigures CLI — ターミナルからアプリの指標、レビュー、ストアデータを照会できます。

インストールせずに今すぐお試しください：

npx @appfigures/cli auth login
npx @appfigures/cli apps search "youtube"

✨ Appfigures AI の力を活用する 4 つの方法

構築方法を問わず、ツール呼び出し、エージェントが記述するコード、CLI、MCP として、Appfigures をエージェントに導入できます。どの方法を選んでも、同じ操作を行い、同じ JSON を取得できます。

• 🛠️ エージェントツール — エージェントの実行中に、ツールとして Appfigures を呼び出します。AI SDK、OpenAI、LangChain に対応しています。→ ツールを追加する
• 📦 クライアント — エージェントが Appfigures に照会するコードを記述し、型付きデータを取得します。→ クライアントを使う
• 🖥️ CLI — ターミナルまたはサンドボックスから Appfigures を実行します。→ @appfigures/cli
• 🔌 MCP — Appfigures を Claude、ChatGPT、Cursor に接続します。→ ホスト型サーバーに接続する

インストール

npm install -g @appfigures/cli

Node.js 22 以降が必要です。pnpm と yarn にも対応しています。

クイックスタート

appfigures auth login
appfigures --help

af エイリアスも利用できます。

認証

• 自分でログインする。 af auth login --interactive を実行すると、ガイドに沿ってログインできるフローがブラウザーで開きます。承認したら、コードを貼り付けてください。
• エージェントに案内してもらう。 デフォルトでは、af auth login を実行すると認証 URL が表示されます。URL を開いて承認し、表示されたコードを使って af auth login --code <code> を実行すれば完了です。エージェントが最初から最後まで処理できます。無人で使用する場合は、代わりに APPFIGURES_API_KEY を設定してください。appfigures.com/developers/keys で Create a New Client をクリックし、続けて Create Personal Access Token をクリックしてトークンを作成します。

どちらの方法でログインしても、トークンは OS の資格情報マネージャー（macOS Keychain、Windows Credential Manager、Linux Secret Service）に保存されます。APPFIGURES_API_KEY やその他の上書き設定については、環境変数をご覧ください。

MCP サーバー

Appfigures は、ホスト型の Model Context Protocol サーバー https://mcp.appfigures.com/mcp を提供しています。リモートサーバーに対応した任意の MCP クライアントに追加し、クライアントから求められたら Appfigures アカウントでサインインしてください。インストールもトークンの管理も不要です。

Claude Code。 次のコマンドで追加し、/mcp を実行してサインインします。

claude mcp add --transport http appfigures https://mcp.appfigures.com/mcp

Claude（ウェブ版およびデスクトップ版）。 URL をカスタムコネクターとして追加します。ディレクトリにないコネクターを追加するをご覧ください。

ChatGPT。 URL を OAuth 対応のカスタム MCP サーバーとして追加します。Appfigures を ChatGPT に接続するをご覧ください。

その他のクライアント。 同じ URL をリモート（Streamable HTTP）サーバーとして追加します。追加場所については、各クライアントの MCP ドキュメントをご覧ください。

ホスト型サーバーでは、Public Data へのアクセスとクレジットを API および CLI と共有します。リクエスト制限とクレジットの消費量については、Appfigures API、CLI、MCP：アクセス、制限、Public Dataをご覧ください。

APPFIGURES_API_KEY で認証するスクリプトやヘッドレスエージェントでは、af コマンドを直接実行するか、コードから @appfigures/agent-toolkit を使用してください。

af mcp（非推奨）

af mcp は、同じツールをローカルの stdio サーバーとして実行します。非推奨となっており、次のメジャーリリースで削除される予定です。それまでは既存の設定を引き続き使用できますが、新しい MCP 機能は追加されません。上記のホスト型サーバーに移行してください。

コマンド

アプリ

アプリを検索し、識別情報を確認します。他のコマンドでは、ここで返されるアプリ ID を使用します。

コマンド	説明
af apps search	名前またはパブリッシャーでアプリを検索します。統合されたアプリごとに 1 行を返します。デフォルトでは Apple と Google の掲載情報が返されます。ほかのストアフロントも含めるには、--all-stores を指定します。推定値（例：先月のダウンロード数が 10 万件を超えるアプリ）でアプリを絞り込むには、explorer list-products を使用します。時間、国、ストアフロント別に分類された推定値を取得するには、データセット estimates.sales または estimates.revenue を指定して metrics query を使用します。
af apps get	アプリのレコードを取得します。基本的なメタデータ（名前、開発者など）と、ユーザーがそのアプリをトラッキングしている場合は、アクセスできるデータが含まれます。1 つのストアフロントにはプロダクト ID を、すべてのストアフロントをまとめて指定するには統合アプリ ID を渡します。
af apps tracked	Appfigures アカウントでトラッキングしているアプリを一覧表示します。
af apps breakdown	トラッキングしているアプリの数を、データグループ（例：売上、使用状況、ランキング、レビュー、キーワード）、ストアフロント、収益化モデル、ソース（自社かトラッキング中の競合か）別に集計します。合計数と最も早いリリース日も表示します。

エクスプローラー

アプリの全カタログを検索・分析します。Apple、Google Play、Amazon などの主要ストアにある数百万件のプロダクトを対象に、識別情報、ストアフロントと国ごとの提供状況、カテゴリ、評価、リリース日、チャートのランキング、ダウンロード数と収益の推定値、SDK の有無、人口統計、関連アプリなど、120 を超えるフィールドを利用できます。

コマンド	説明
af explorer list‑products	1 つまたは複数のアプリのカタログフィールドを読み取ります。query または sort で参照したフィールドは自動的に返されます。さらにフィールドを取得するには、--extra-fields を指定します。1 つのアプリには ["match","product_id",<id>] を使用します。複数の条件を組み合わせて、対象全体を検索することもできます（例：Firebase を使用している、米国での収益が 100 万ドル以上の iOS アプリ）。120 を超えるフィールドには、ランキング、評価、ダウンロード数と収益の推定値、SDK、人口統計などが含まれます。クエリ文法とフィールド一覧は docs get catalog_playbook を参照してください。
af explorer aggregate‑products	Apple、Google Play、Amazon などの主要ストアにある数百万件のプロダクトからなるカタログ全体を対象に、条件に一致するプロダクトの件数、平均、最小値と最大値、ヒストグラムを集計します。explorer list-products と同じクエリ文法を使用します。プロダクトのレコードではなく、集計値を返します。市場規模の推定、ベンチマーク、セグメント分析に使用できます。
af explorer describe‑fields	カタログのフィールドと、それぞれに対する現在のユーザーのアクセスレベルを一覧表示します。キーワードで検索してフィールドを見つけられます。explorer list-products と explorer aggregate-products が受け付けるものと同じフィールドセットです。

メトリクス

ディメンション別に数値データセットをクエリします。

コマンド	説明
af metrics query	1つ以上のアプリについて、任意の数値データセットをクエリします。必要に応じて最大2つのディメンションでグループ化でき、アプリのレコードではなく、ネストされたパーティションツリーとして返されます。国、デバイスタイプ、日付範囲で個別にフィルタリングできます。filterAppsBy* オプションでアプリセットを絞り込めます（ID、ストアフロント、ソース、タイプを指定）。指定しない場合、アカウントで追跡しているすべてのアプリが対象になります。
af metrics describe‑datasets	metrics query で指定できるすべての数値データセットを一覧表示します。データセットごとに1行で、値の型と、自分のアプリのみに制限されているかどうかを示します。

ストア

アプリストアでの掲載状況：掲載情報の内容、カテゴリランキング、トップチャート、特集掲載。

コマンド	説明
af store app‑ranks	1つ以上のアプリについて、国、デバイスタイプ、カテゴリサブタイプ、カテゴリごとのランキング履歴を、日次の変動幅とともに時系列で確認します。
af store top‑charts	指定した国とカテゴリのカテゴリチャートで、現在の順位と日次の変動幅を含む上位アプリを一覧表示します。
af store categories	ID付きですべてのストアカテゴリを一覧表示します。store app-ranks --category-ids と store top-charts --category-id で必要な数値のカテゴリIDを確認できます。
af store featured	アプリまたはストアフロントの商品について、特集掲載と編集部による掲載を一覧表示します。概要統計のみを取得する場合は、0件をリクエストします。
af store app‑listing	1つのストアフロントについて、ストア掲載情報全体を読み取ります。ローカライズされたテキスト（名前、サブタイトル、説明、リリースノート）に加え、スクリーンショット、動画、カテゴリ、収益化、対応デバイス、国別の提供状況、価格、評価、ファイルサイズ、年齢制限が含まれます。数値の商品IDを指定します（1回につき1つのストアフロント。統合アプリにはストアフロントごとに1つの商品があります）。リクエストごとに指定できるロケールは1つです。

オーディエンス

アプリのユーザー層と、ユーザーがほかに利用しているアプリを確認します。推定年齢・性別と、ほかのアプリとのオーディエンスの重複を扱います。

コマンド	説明
af audience demographics	アプリのオーディエンスの属性情報を読み取ります。推定年齢・性別の内訳を確認できます。
af audience cross‑usage	あるアプリのユーザーがほかにも利用しているアプリを見つけます。

レビュー

iOS および Google Play のアプリストアレビューを検索、要約、返信します。

コマンド	説明
af reviews list	1つ以上のアプリの個別レビューを読み取ります。レビュー本文、星評価、国、アプリのバージョン、返信が返されます。星評価、日付範囲、国、バージョン、返信状況、追跡関係で絞り込めます。
af reviews breakdown	1つ以上のアプリのレビュー件数を、ディメンションごとに集計します。一致した対象全体の合計に加え、ディメンション値ごとに1件のカウントを返します。
af reviews reply	特定のレビューに対する開発者の返信を投稿または取り消します。投稿する場合は content を渡し、投稿済みの返信を取り消す場合は delete: true を渡します。

キーワード

オーガニック検索（App Store、Google Play）と Apple Ads におけるキーワードの可視性、順位の追跡、発見。

コマンド	説明
af keywords organic	1 つ以上のアプリが順位を獲得しているオーガニックキーワードを、順位、人気度、競争率とともに確認します。
af keywords paid	1 つ以上のアプリが広告を掲載している有料キーワードを、インプレッションシェアとオーガニック順位とともに一覧表示します。
af keywords tracked‑ranks	1 つのアプリと国の組み合わせについて、追跡中のすべてのキーワードの順位を表示します。各キーワードの現在の順位、前回変動してからの変化、開始時の順位、人気度、競争率が含まれます。
af keywords tracked‑trend	1 つのアプリと国の組み合わせについて、追跡中の 1 つのキーワードの順位が時間とともにどう変化するかを追跡します。各時点の順位と、その前の時点からの順位変動が表示されます。
af keywords suggestions	1 つのアプリと国の組み合わせについて、ターゲットとして検討できるキーワード案を見つけます。アプリとの関連性順に並び、競合アプリから抽出したキーワードも含まれます。各キーワードの人気度、競争率、アプリの現在の順位も表示されます。
af keywords ranking‑apps	オーガニック検索で特定のキーワードの順位を獲得しているアプリを、そのキーワード自体の人気度と競争率のスコアとともに一覧表示します。
af keywords advertisers	特定のキーワードに広告を掲載しているアプリを、各広告主のインプレッションシェア、オーガニック順位、入札開始からの期間とともに一覧表示します。
af keywords related	ASO 調査用に、シードキーワードに関連するキーワードを見つけます。似たオーディエンスを持ち、より人気が高い、または競争率が低い代替キーワードを見つけるのに役立ちます。
af keywords tracked	追跡中のキーワードを、不透明な ID とともに一覧表示します。
af keywords track	キーワードを追跡し、アプリのそのキーワードにおける順位を時間単位で監視するとともに、順位が変動した際に自動アラートを受け取ります。
af keywords untrack	キーワードの追跡を停止します。

Apple Ads

Apple Ads のキャンペーン、広告グループ、キーワード、パフォーマンスを管理します。

コマンド	説明
af apple‑ads organizations	キャンペーンを管理している Apple Ads の組織を、それぞれの通貨とタイムゾーンとともに一覧表示します。
af apple‑ads campaigns	Apple Ads のキャンペーンを、それぞれのステータス、予算、ターゲット国、スケジュールとともに一覧表示します。
af apple‑ads ad‑groups	Apple Ads の広告グループを、それぞれのデフォルト入札額、CPA 上限、価格モデル、スケジュールとともに一覧表示します。
af apple‑ads keywords	キャンペーンの入札対象キーワードを、指定した期間における各キーワードのパフォーマンス（インプレッション数、タップ数、インストール数、費用、インストール単価）、マッチタイプ、入札額、ターゲティング語句か除外語句かとともに一覧表示します。
af apple‑ads search‑terms	キャンペーン広告の表示につながった実際のユーザー検索語句を、各語句の全期間のパフォーマンス（インプレッション数、タップ数、インストール数、費用、インストール単価）とともに一覧表示します。入札対象に追加する新しいキーワードや除外するキーワードを見つけるために使用します。
af apple‑ads report	指定した期間について、キャンペーンごとの Apple Ads のパフォーマンス（インプレッション数、タップ数、インストール数、費用、インストール単価）と、アカウント全体の合計をレポートします。
af apple‑ads top‑keywords	指定した期間について、コンバージョン率、費用、インストール数でキャンペーンの上位キーワードをランキング表示します。各リストには、1 つの指標に基づく上位キーワードが表示されます。

Sdks

追跡対象の SDK を検索します。

コマンド	説明
af sdks list	既知のすべての SDK を ID とともに一覧表示するか、検索して特定の SDK を見つけます。

Docs

特定の操作や一般的なタスクに関するリファレンスドキュメントとガイドです。

コマンド	説明
af docs get	スラッグでリファレンスドキュメントまたはガイドを取得します。

API

コマンド	説明
af api	専用コマンドがないエンドポイントに対して、生の API リクエストを実行します。エンドポイント、パラメーター、レスポンスの形式については、https://docs.appfigures.com をご覧ください。

MCP

コマンド	説明
af mcp	（非推奨）stdio 経由でローカル MCP サーバーを実行します。代わりに、ホスト型の Appfigures MCP サーバーを使用してください：https://mcp.appfigures.com/mcp

Auth

コマンド	説明
af auth login	Appfigures にサインインします
af auth logout	保存された認証情報を削除します
af auth status	認証とアカウントのステータスを表示します

引数、フラグ、使用例を確認するには、af <command> --help を実行してください。

Environment

変数	用途
APPFIGURES_API_KEY	API キー。対話型認証をスキップします
AF_VERBOSE	HTTP を stderr に記録します（-v と同じです）
NO_COLOR	ANSI カラーを無効にします
NO_UPDATE_NOTIFIER	npm レジストリの更新チェックをスキップします
CI	更新チェックもスキップします（任意の CI システムで有効）

API リファレンス

引数とフラグの一覧を含む、すべてのコマンドです。1 行の概要については、上記のコマンドを参照してください。

グローバルフラグ。 すべてのコマンドで以下を使用できます。

• -v, --verbose — HTTP リクエストを stderr に記録します。AF_VERBOSE=1 でも設定できます。
• -V, --version — CLI のバージョンを表示して終了します。
• -h, --help — 現在のコマンドの使い方を表示します。

出力形式。 すべてのコマンドは stdout に単一の JSON 値を出力します。フィルタリングには jq にパイプしてください。情報メッセージ、ヒント、アップデート通知は stderr に出力されるため、パイプラインはクリーンな状態に保たれます。

af apps search

af apps search <q> [flags]

名前またはパブリッシャーでアプリを検索します。統合されたアプリごとに 1 行を返します。デフォルトでは Apple と Google の掲載情報を返します。ほかのストアフロントを含めるには、--all-stores を指定してください。推定値でアプリを絞り込む場合（例：先月のダウンロード数が 10 万件を超えるアプリ）は、explorer list-products を使用してください。時間、国、ストアフロント別の推定値を取得するには、データセット estimates.sales または estimates.revenue を指定して metrics query を使用してください。

オプション

• <q> 必須の文字列。検索クエリ（アプリ名またはパブリッシャー）。
• --all-stores ブール値、デフォルトは false。Apple と Google 以外のストアフロント（Amazon、Windows、Steam、Roku、LG TV、Samsung TV など）を含めます。
• --count 整数、デフォルトは 10。返す結果の数。
• --page 整数、デフォルトは 1。ページ番号。

例

# Find every Electronic Arts app.
af apps search 'electronic arts'

# Page through long results.
af apps search 'electronic arts' --count=25 --page=2

# Find Minecraft on every storefront (e.g. Amazon, Steam, Windows, Roku; not common).
af apps search minecraft --all-stores

---

af apps get

af apps get <app-id> [flags]

アプリのレコードを取得します。基本的なメタデータ（名前、開発者など）と、ユーザーがそのアプリを追跡している場合はアクセス可能なデータが含まれます。1 つのストアフロントにはプロダクト ID を、すべてのストアフロントをまとめて取得するには統合アプリ ID を指定してください。

オプション

• <app-id> 必須の整数または文字列。アプリの統合アプリ ID またはプロダクト ID。
• --all-stores ブール値、デフォルトは false。統合アプリ ID の場合、すべてのストアフロント（Amazon、Steam、Windows、Roku など）にわたるメンバー製品を含めます。false の場合、member_products はアプリインテリジェンスの対象ストアフロント（iOS と Google Play）に限定されます。プロダクト ID の場合は無視されます。

例

# Get Minecraft's unified-app record (iOS + Google Play by default).
af apps get ua_X7iNgb

# Get Minecraft's Google Play product record.
af apps get 6938219

---

af apps tracked

af apps tracked [flags]

Appfigures アカウントで追跡しているアプリを一覧表示します。

オプション

• --count 整数、デフォルトは 10。返す結果の数。
• --page 整数、デフォルトは 1。ページ番号。
• --q 文字列。フィルタリングするアプリ名。
• --filter-apps-by-id（整数または文字列）[]。プロダクト ID または統合アプリ ID で指定した特定のアプリのデータのみを含めます。設定すると、ほかの filterAppsBy* キーより優先されます。条件で表せるアプリの集合には、ストアフロント、ソース、またはタイプによるフィルターが適しています。
• --filter-apps-by-storefront 文字列[]。アカウントで追跡しているアプリを、指定したストアフロント（例：apple:ios、google_play）に絞り込みます。
• --filter-apps-by-source 文字列[]。追跡関係に基づいて、アカウントで追跡しているアプリを絞り込みます。
• --filter-apps-by-type 文字列[]。指定したタイプのプロダクトに、アカウントで追跡しているアプリを絞り込みます。

例

# List your apps with private-data access.
af apps tracked --filter-apps-by-source=own,shared

# List your tracked fitness apps.
af apps tracked --q=fitness

# List just your iOS apps.
af apps tracked --filter-apps-by-storefront=apple:ios

# Page through long results.
af apps tracked --filter-apps-by-source=own,shared --count=50 --page=2

# List tracked competitors.
af apps tracked --filter-apps-by-source=manual

# Find individual IAPs or subscriptions (not common).
af apps tracked --filter-apps-by-type=inapp,subscription

---

af apps breakdown

af apps breakdown [flags]

グループ（例：売上、使用状況、ランキング、レビュー、キーワード）、ストアフロント、収益化モデル、ソース（自社アプリか、追跡中の競合アプリか）ごとに追跡中のアプリ数を集計し、合計と最も古いリリース日も表示します。

オプション

• --filter-apps-by-id (integer or string)[]. 製品 ID または統合アプリ ID で指定したアプリのデータのみを対象にします。設定すると、他の filterAppsBy* キーより優先されます。基準で表せるアプリ群には、ストアフロント、ソース、タイプのフィルターが適しています。
• --filter-apps-by-storefront string[]. アカウントで追跡中のアプリを、指定したストアフロント（例：apple:ios、google_play）に絞り込みます。
• --filter-apps-by-source string[]. アカウントで追跡中のアプリを、追跡関係で絞り込みます。
• --filter-apps-by-type string[]. アカウントで追跡中のアプリを、指定したタイプの製品に絞り込みます。

使用例

# Check what data the whole account has.
af apps breakdown

# Limit to apps you own or that were shared with you.
af apps breakdown --filter-apps-by-source=own,shared

# Limit to your iOS apps.
af apps breakdown --filter-apps-by-storefront=apple:ios

---

af explorer list-products

af explorer list-products [flags]

1 つまたは複数のアプリのカタログフィールドを読み取ります。query または sort で参照したフィールドは自動的に返されます。それ以外のフィールドを取得するには --extra-fields を指定します。単一のアプリを指定するには ["match","product_id",<id>] を使用します。複数のフィルターを組み合わせると、母集団のクエリ（例：Firebase を使用し、米国での収益が 100 万ドル以上の iOS アプリ）を実行できます。120 以上のフィールドがランキング、評価、ダウンロード数と収益の推定値、SDK、ユーザー属性などを網羅しています。クエリ文法とフィールド一覧は docs get catalog_playbook に記載されています。

オプション

• --query array、デフォルトは []。一致するカタログ製品を選択するための、JSON 配列形式の Explorer クエリです。デフォルトでは有効な製品が対象です。無効な製品も含めるには、["match","active",["or",true,false]] を指定します。フィールド一覧とクエリ構文の詳細は docs get catalog_playbook に記載されています。
• --extra-fields string[]. query または sort ですでに参照されているフィールド以外に含める追加フィールドです。フィールドパスと読み取り可能なフィールドは、explorer describe-fields で確認できます。
• --sort string。Explorer のフィールド名です。フィールド一覧は docs get catalog_playbook に記載されています。
• --order string、デフォルトは desc。並べ替えの方向です。
• --count integer、デフォルトは 10。返す結果の数です。
• --page integer、デフォルトは 1。ページ番号です。
• --allow-unscoped-nested boolean、デフォルトは false。意図的に広範なクエリを実行するためのオプションです。結果が通常膨らむ、スコープ指定のないネスト述語をデフォルトでブロックする機能を無効にします。

使用例

# Find iOS apps that have Firebase installed.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["nested","all_sdks",["and",["match","all_sdks.id","firebase"],["match","all_sdks.active",true]]]]'

# Rank the biggest US iOS games by revenue.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["match","categories.all",6014]]' --sort='custom_meta[country=us].revenue_estimates_sum_30_days' --order=desc --count=25

# Find US iOS apps in the $100k–$1M/month revenue tier.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["nested","custom_meta",["and",["match","custom_meta.country","us"],["match","custom_meta.revenue_estimates_sum_30_days",["number_range",100000,1000000]]]]]'

# Page through results.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["match","categories.all",6014]]' --count=50 --page=2

# Pass `--extra-fields` for columns the query doesn't already reference. Common for single-app reads.
af explorer list-products --query='["match","product_id",304004187384]' --extra-fields='custom_meta[country=zz].revenue_estimates_sum_365_days,all_sdks[id=firebase].active'

---

af explorer aggregate-products

af explorer aggregate-products <fields> [flags]

Apple、Google Play、Amazon などの主要ストアにまたがる数百万件の製品の全カタログを対象に、該当する製品の任意の組み合わせについて、件数、平均、最小値／最大値、ヒストグラムを集計します。explorer list-products と同じクエリー文法を使用し、製品レコードではなく集計結果を返します。市場規模の推定、ベンチマーク、セグメント分析に使用できます。

オプション

• <fields> 必須の文字列配列。フィールドと集計のペア（例：all_rating/stats、storefronts/terms）。集計の種類：stats、terms、histogram、date_histogram、cardinality。フィールドの全一覧は docs get catalog_playbook に記載されています。
• --query 配列、デフォルトは []。カタログ内の該当する製品を選択するための、JSON 配列形式の Explorer クエリーです。デフォルトではアクティブな製品が対象です。非アクティブな製品も含めるには、["match","active",["or",true,false]] を指定します。フィールドの全一覧とクエリー構文は docs get catalog_playbook に記載されています。
• --allow-unscoped-nested 真偽値、デフォルトは false。意図的に広範なクエリーを実行するための回避オプションです。通常は結果を水増しする、スコープ指定のないネスト述語をブロックするデフォルトの制限を回避します。
• --terms-count 整数、デフォルトは 20。各 terms 集計で返すバケットの最大数です。その他の集計タイプでは無視されます。
• --date-histogram-interval 文字列。各 date_histogram 集計のバケット間隔です。その他の集計タイプでは無視されます。

例

# How many monthly downloads does an average iOS app get in Japan?
af explorer aggregate-products 'custom_meta[country=jp].download_estimates_average_30_days/stats' --query='["and",["match","storefronts","apple:ios"],["match","countries","jp"]]'

# What's the rating, category mix, and developer concentration for US iOS apps in the $100k–$10M/mo net-revenue tier?
af explorer aggregate-products all_rating/stats,categories.all/terms,developer_id/cardinality --query='["and",["match","storefronts","apple:ios"],["nested","custom_meta",["and",["match","custom_meta.revenue_estimates_sum_30_days",["number_range",100000,10000000]],["match","custom_meta.country","us"]]]]'

# Are new iOS games still launching at the same rate as two years ago?
af explorer aggregate-products release_date/date_histogram --query='["and",["match","storefronts","apple:ios"],["match","categories.all",6014],["match","release_date",["range","2024-01-01","2025-12-31"]]]'

# What SDKs do apps commonly ship alongside OneSignal?
af explorer aggregate-products 'all_sdks[*].id/terms' --query='["nested","all_sdks",["and",["match","all_sdks.id","onesignal"],["match","all_sdks.active",true]]]'

# How do iOS app ratings distribute?
af explorer aggregate-products all_rating/histogram --query='["match","storefronts","apple:ios"]'

# How many apps are on each storefront?
af explorer aggregate-products storefronts/terms

---

af explorer describe-fields

af explorer describe-fields [flags]

カタログのフィールドと、それぞれに対する現在のユーザーのアクセスレベルを一覧表示します。キーワードでフィールドを検索できます。explorer list-products と explorer aggregate-products で受け付けるフィールドと同じです。

オプション

• --count 整数、デフォルトは 50。返す結果の数です。
• --page 整数、デフォルトは 1。ページ番号です。
• --q 文字列。path、title、description、type で絞り込みます。

例

# Search for revenue-related fields.
af explorer describe-fields --q=revenue

# List every catalog field with the current user's access level.
af explorer describe-fields

---

af metrics query

af metrics query <dataset> [flags]

1 つ以上のアプリについて、任意の数値データセットをクエリします。オプションで最大 2 つのディメンションごとにグループ化でき、アプリのレコードではなく、入れ子になったパーティションツリーとして返されます。国、デバイスタイプ、日付範囲でそれぞれ独立してフィルタリングできます。filterAppsBy* オプションを指定すると、ID、ストアフロント、ソース、タイプでアプリセットを絞り込めます。指定しない場合、クエリの対象はアカウントでトラッキングしているすべてのアプリです。

オプション

• <dataset> 必須の文字列。クエリするデータセットです（例：sales.combined_downloads）。すべてのデータセットと、どのデータセットがプライベートデータ（所有するアプリ、または共有されたアプリでのみ表示可能）かについては、metrics describe-datasets を参照してください。
• --group-by 文字列[]. グループ化するディメンションです。最大 2 つ指定できます。最初のスロットが外側のエンティティタイプになり、2 つ目が内側の系列になります。ディメンションごとに結果のサイズが増加します。
• --granularity 文字列。日付でグループ化する場合の時間粒度です。
• --count 整数。行数の上限です。--group-by を指定した場合、値の大きい順に外側のエンティティタイプの上位 N 件を返します（日付でグループ化した場合は最も早い N 件）。--group-by を指定しない場合は、単一ページのプレビューになります。
• --countries 文字列[]. 1 つ以上の ISO 国コード（例：US、JP、GB）で絞り込みます。
• --device-type 文字列。デバイスタイプです。
• --all-time ブール値、デフォルトは false。全期間の履歴を対象にします。このフラグを指定せず、start／end も指定しない場合、クエリの対象期間はデフォルトで過去 30 日間になります。start および end とは併用できません。
• --filter-apps-by-id (整数または文字列)[]. 製品 ID または統合アプリ ID で特定のアプリのデータのみを対象にします。設定すると、他の filterAppsBy* キーより優先されます。基準で表せるアプリセットには、ストアフロント、ソース、タイプによるフィルターが適しています。
• --filter-apps-by-storefront 文字列[]. アカウントでトラッキングしているアプリを、指定したストアフロント（例：apple:ios、google_play）に絞り込みます。
• --filter-apps-by-source 文字列[]. トラッキング関係で、アカウントでトラッキングしているアプリを絞り込みます。
• --filter-apps-by-type 文字列[]. アカウントでトラッキングしているアプリを、指定したタイプの製品に絞り込みます。
• --start 文字列。開始日（YYYY-MM-DD）です。
• --end 文字列。終了日（YYYY-MM-DD、デフォルトは今日）です。

例

# Get total downloads across your apps with private-data access.
af metrics query sales.combined_downloads --filter-apps-by-source=own,shared

# Get revenue split by storefront, plus a top-level total.
af metrics query sales.combined_revenue --filter-apps-by-source=own,shared --group-by=storefront

# Rank the top 5 tracked competitors by estimated monthly revenue.
af metrics query estimates.revenue --filter-apps-by-source=manual --group-by=product --count=5

# Track Candy Crush Saga's daily download estimates.
af metrics query estimates.sales --filter-apps-by-id=ua_V1Q1uX --group-by=date --granularity=daily

# Track net monthly recurring revenue per app, month over month.
af metrics query subscriptions.mrr --filter-apps-by-source=own,shared --group-by=product,date --granularity=monthly

# Get Minecraft's new ratings.
af metrics query ratings.new_total --filter-apps-by-id=ua_X7iNgb

# Track daily ad spend across your apps.
af metrics query adspend.cost --filter-apps-by-source=own,shared --group-by=date --granularity=daily

# Compare Candy Crush's December 2025 downloads across the US, Japan, and UK.
af metrics query estimates.sales --filter-apps-by-id=ua_V1Q1uX --countries=US,JP,GB --group-by=country --start=2025-12-01 --end=2025-12-31

# Track all-time monthly revenue across your apps with private-data access.
af metrics query sales.combined_revenue --filter-apps-by-source=own,shared --group-by=date --granularity=monthly --all-time

# Get Minecraft's review volume by country.
af metrics query reviews.total --filter-apps-by-id=ua_X7iNgb --group-by=country

---

af metrics describe-datasets

af metrics describe-datasets [flags]

metrics query で指定できるすべての数値データセットを一覧表示します。各データセットについて、値のタイプと自分のアプリに限定されるかどうかを 1 行ずつ表示します。

オプション

• --count 整数、デフォルトは 50。返す結果の件数です。
• --page 整数、デフォルトは 1。ページ番号です。
• --q 文字列。dataset、value_type、label、description で絞り込みます。

例

# Search by keyword (matches name, label, or description).
af metrics describe-datasets --q='combined downloads'

# Look up one dataset by its exact name.
af metrics describe-datasets --q=sales.combined_downloads

# List every dataset with its value type and whether it's limited to your own apps.
af metrics describe-datasets

---

af store app-ranks

af store app-ranks <app-ids> [flags]

複数の国、デバイスタイプ、カテゴリのサブタイプ、カテゴリにわたって、1 つ以上のアプリの順位履歴を、日次の順位変動とともに時系列で追跡します。

オプション

• <app-ids> 必須（integer または string）[]。アプリ識別子（統合アプリ ID または製品 ID）
• --countries string[]。照会する国コード。順位データがあるすべての国がデフォルトで対象になります。
• --granularity string、デフォルトは hourly。サンプリング頻度です。hourly は最新のデータを取得します。複数日にわたる履歴を簡潔に取得するには、--granularity=daily を指定します。
• --device-types string[]、デフォルトは ["handheld"]。対象に含めるデバイスタイプです。それぞれ別のチャートで順位が表示されます。レスポンスの対象を広げるには、さらに追加します。
• --subtypes string[]、デフォルトは ["free","paid"]。対象に含めるカテゴリのサブタイプです。それぞれ別のチャートで順位が表示されます。レスポンスの対象を広げるには、さらに追加します。
• --category-ids integer[]。レスポンスの行を特定のカテゴリ ID に絞り込みます。すべてを対象にする場合は省略します。カテゴリ ID は store categories で確認できます。
• --start string。開始日（YYYY-MM-DD）
• --end string。終了日（YYYY-MM-DD、デフォルトは今日）
• --count integer、デフォルトは 10。返す結果の数です。
• --page integer、デフォルトは 1。ページ番号です。

例

# Check ChatGPT's current ranks (unified app).
af store app-ranks ua_miTXv6 --countries=US

# Check ChatGPT's current ranks on one storefront.
af store app-ranks 336744124021 --countries=US

# Compare ChatGPT's ranks across the US, UK, and Japan.
af store app-ranks ua_miTXv6 --countries=US,GB,JP

# Check Procreate's paid iPad chart ranks.
af store app-ranks ua_CxA1MS --subtypes=paid --device-types=tablet --countries=US

# Trace ChatGPT's chart history through December 2025.
af store app-ranks ua_miTXv6 --granularity=daily --start=2025-12-01 --end=2025-12-31 --countries=US

# Check ChatGPT's rank in one category (US iOS Productivity).
af store app-ranks 336744124021 --category-ids=6007 --countries=US

---

af store top-charts

af store top-charts [flags]

指定した国とカテゴリのカテゴリチャートで、現在の順位と日次の順位変動とともに上位のアプリを一覧表示します。

オプション

• --country 必須 string。ISO 国コード（例：US、JP、GB）
• --category-id 必須 integer。カテゴリ ID は store categories で確認できます。
• --subtype string、デフォルトは free。カテゴリのサブタイプ（カテゴリ内のチャート種別）です。
• --date string。スナップショットの日付（YYYY-MM-DD、デフォルトは現在の日付）
• --count integer、デフォルトは 10。返す結果の数です。
• --page integer、デフォルトは 1。ページ番号です。

例

# Find the Games category, then pull its US chart.
af store categories --q=games
af store top-charts --country=US --category-id=6014

# List top paid apps on the US App Store.
af store top-charts --country=US --category-id=25204 --subtype=paid

# List top free apps on the Japan App Store.
af store top-charts --country=JP --category-id=25204

# List top free apps on Google Play in the US.
af store top-charts --country=US --category-id=100

# List top free apps on the US App Store in December 2025.
af store top-charts --country=US --category-id=25204 --date=2025-12-01

---

af store categories

af store categories [flags]

すべてのストアカテゴリを ID とともに一覧表示します。store app-ranks --category-ids および store top-charts --category-id で必要となる数値のカテゴリ ID をここで確認できます。

オプション

• --count integer、デフォルトは 50。返す結果の数です。
• --page integer、デフォルトは 1。ページ番号です。
• --q string。name で絞り込みます。
• --sort string。並べ替えに使用するフィールドです。q を指定した場合は関連度順、それ以外の場合はリスト順になるため、省略できます。
• --order string、デフォルトは desc。並べ替えの方向です。
• --category-id integer[]。指定したカテゴリ ID のみを返します。
• --parent-id integer。指定した親カテゴリのサブカテゴリのみを含めます（ID で絞り込み）。
• --storefront string[]。指定したストアフロントのカテゴリのみを含めます（例：apple:ios、google_play）。
• --device-type string[]。指定したデバイスタイプのカテゴリのみを含めます（例：handheld、tablet）。
• --all boolean、デフォルトは false。順位データのないストア（roku、vizio など）を含めます。これらのストアにはカテゴリがありますが、順位データはありません。

例

# Find the Games category.
af store categories --q=games

# List every Apple iOS category.
af store categories --storefront=apple:ios

# List subcategories of a parent category (here, Apple Games).
af store categories --parent-id=6014

# Include categories from non-rank-supporting stores (e.g. Roku, Vizio) (not common).
af store categories --all

---

af store featured

af store featured <app-id> [flags]

アプリまたはストアフロントの商品に掲載されたおすすめ枠や特集枠を一覧表示します。概要統計のみを取得する場合は、0行をリクエストしてください。

オプション

• <app-id> 必須の整数または文字列。アプリの統合アプリ ID または商品 ID です。
• --countries string[]。対象に含める国です。省略すると米国のみを検索します。複数指定すると市場を比較できます。すべての国を対象にするには、代わりに --all-countries を設定してください。
• --all-countries boolean、デフォルトは false。すべての国を対象にします。--countries と同時に指定できません。
• --include-rank-trend boolean、デフォルトは false。各掲載枠について、期間ごとの rank_trend を含めます。
• --sort string、デフォルトは relevance。掲載枠を関連性または日付で並べ替えます。
• --order string、デフォルトは desc。並べ替えの順序です。
• --start string。開始日（YYYY-MM-DD）
• --end string。終了日（YYYY-MM-DD、デフォルトは今日）。期間は最大31日です。
• --count integer、デフォルトは 10。返す結果の数です。
• --page integer、デフォルトは 1。ページ番号です。

例

# List Minecraft's recent featured placements (unified app).
af store featured ua_X7iNgb

# List Minecraft's recent featured placements on one storefront.
af store featured 10157213

# Compare Minecraft's placement coverage across the US, UK, and Japan.
af store featured ua_X7iNgb --countries=US,GB,JP

# List Minecraft's placements during a specific month (December 2025).
af store featured ua_X7iNgb --start=2025-12-01 --end=2025-12-31

# List Minecraft's placements with rank history.
af store featured ua_X7iNgb --include-rank-trend

# List Minecraft's placements sorted by end date, newest run first.
af store featured ua_X7iNgb --sort=date --order=desc

# Get Minecraft's placement summary only.
af store featured ua_X7iNgb --count=0

---

af store app-listing

af store app-listing <product-id> [flags]

ストアフロント1つ分の完全なストア掲載情報を取得します。ローカライズされたテキスト（名前、サブタイトル、説明、リリースノート）に加え、スクリーンショット、動画、カテゴリ、収益化、対応デバイス、国ごとの提供状況、価格、評価、ファイルサイズ、年齢制限が含まれます。数値の商品 ID を指定します（1回につき1つのストアフロント。統合アプリはストアフロントごとに1つの商品があります）。リクエストごとに指定できるロケールは1つです。

オプション

• <product-id> 必須の整数。1つのストアフロントの商品 ID（数値）です。統合アプリ ID ではありません。メンバーの商品 ID の値は apps get '<unified-app-id>' で確認できます。
• --language string。名前、サブタイトル、説明、リリースノート、スクリーンショットに使用するロケール（例：en、ja、zh-Hans）です。デフォルトは en です。指定したロケールにメタデータがない場合は、最初に利用可能なロケールにフォールバックします。レスポンスには解決された言語が含まれます。
• --device-type string、デフォルトは handheld。Apple のアプリに関係します。iPhone 固有のメタデータには handheld、iPad には tablet、Mac には desktop などを選択してください。

例

# Read Minecraft's store listing.
af store app-listing 10157213

# Read Minecraft's Japanese-localized listing.
af store app-listing 10157213 --language=ja

# Read Minecraft's iPad screenshots.
af store app-listing 10157213 --device-type=tablet

---

af audience demographics

af audience demographics <app-id>

アプリのオーディエンスのデモグラフィック情報、つまり推定される年齢と性別の内訳を取得します。

オプション

• <app-id> 必須の整数または文字列。アプリの統合アプリ ID または商品 ID です。

例

# Read Minecraft's audience across all its storefronts (unified app ID).
af audience demographics ua_X7iNgb

# Read Minecraft's audience on Google Play only (product ID).
af audience demographics 6938219

---

af audience cross-usage

af audience cross-usage <app-id> [flags]

このアプリのユーザーがほかに利用しているアプリを検索します。

オプション

• <app-id> 必須の整数または文字列。アプリの統合アプリ ID または商品 ID です。
• --count integer、デフォルトは 10。返す結果の数です。
• --page integer、デフォルトは 1。ページ番号です。

例

# Find the apps ChatGPT's users also use (unified app ID).
af audience cross-usage ua_miTXv6

# Find the apps ChatGPT's users also use on the App Store only (product ID).
af audience cross-usage 336744124021

---

af reviews list

af reviews list [flags]

1 つ以上のアプリの個別レビューを読み込みます。レビュー本文、星評価、国、アプリのバージョン、および返信が返されます。星評価、日付範囲、国、バージョン、返信状況、トラッキング関係で絞り込めます。

オプション

• --stars number[]. 星評価で絞り込みます。
• --versions string[]. アプリのバージョンで絞り込みます。複数指定すると、それらを組み合わせます。
• --countries string[]. 1 つ以上の ISO 国コード（例：US、JP、GB）で絞り込みます。
• --q string. レビューのタイトルと本文を検索します。複数のキーワードを指定すると、いずれかに一致するものが対象になります。大文字と小文字は区別されず、他のフィルターと組み合わせて使用できます。
• --response-status string. 返信済みかどうかで絞り込みます。省略すると、すべてのレビューが対象になります。
• --sort string. レビューの日付または星評価で並べ替えます。
• --order string, default desc. 並べ替えの順序です。
• --filter-apps-by-id (integer or string)[]. 商品 ID または統合アプリ ID で指定したアプリのデータのみを対象にします。設定すると、他の filterAppsBy* キーより優先されます。ストアフロント、ソース、またはタイプの条件で表せるアプリ群には、それらのフィルターが適しています。
• --filter-apps-by-storefront string[]. アカウントでトラッキング中のアプリを、指定したストアフロント（例：apple:ios、google_play）に絞り込みます。
• --filter-apps-by-source string[]. アカウントでトラッキング中のアプリを、トラッキング関係で絞り込みます。
• --filter-apps-by-type string[]. アカウントでトラッキング中のアプリを、指定したタイプの商品に絞り込みます。
• --start string. 開始日（YYYY-MM-DD）
• --end string. 終了日（YYYY-MM-DD、デフォルトは今日）
• --count integer, default 10. 返す結果の数です。
• --page integer, default 1. ページ番号です。1～500。

例

# Read Minecraft's recent reviews.
af reviews list --filter-apps-by-id=ua_X7iNgb

# Read Minecraft's 5-star reviews.
af reviews list --filter-apps-by-id=ua_X7iNgb --stars=5

# Compare Minecraft's reviews across the US, Japan, and the UK.
af reviews list --filter-apps-by-id=ua_X7iNgb --countries=US,JP,GB

# Read Minecraft's December 2025 reviews.
af reviews list --filter-apps-by-id=ua_X7iNgb --start=2025-12-01 --end=2025-12-31

# Page through long results across your own apps.
af reviews list --filter-apps-by-source=own --count=50 --page=2

# Find your 1-2 star reviews without a response.
af reviews list --filter-apps-by-source=own --stars=1,2 --response-status=without_response

---

af reviews breakdown

af reviews breakdown [flags]

1 つ以上のアプリのレビュー数をディメンション別に集計します。一致した対象全体の合計に加え、各ディメンション値の件数を返します。

オプション

• --stars number[]. 星評価で絞り込みます。
• --versions string[]. アプリのバージョンで絞り込みます。複数指定すると、それらを組み合わせます。
• --countries string[]. 1 つ以上の ISO 国コード（例：US、JP、GB）で絞り込みます。
• --q string. レビューのタイトルと本文を検索します。複数のキーワードを指定すると、いずれかに一致するものが対象になります。大文字と小文字は区別されず、他のフィルターと組み合わせて使用できます。
• --response-status string. 返信済みかどうかで絞り込みます。省略すると、すべてのレビューが対象になります。
• --filter-apps-by-id (integer or string)[]. 商品 ID または統合アプリ ID で指定したアプリのデータのみを対象にします。設定すると、他の filterAppsBy* キーより優先されます。ストアフロント、ソース、またはタイプの条件で表せるアプリ群には、それらのフィルターが適しています。
• --filter-apps-by-storefront string[]. アカウントでトラッキング中のアプリを、指定したストアフロント（例：apple:ios、google_play）に絞り込みます。
• --filter-apps-by-source string[]. アカウントでトラッキング中のアプリを、トラッキング関係で絞り込みます。
• --filter-apps-by-type string[]. アカウントでトラッキング中のアプリを、指定したタイプの商品に絞り込みます。
• --start string. 開始日（YYYY-MM-DD）
• --end string. 終了日（YYYY-MM-DD、デフォルトは今日）
• --by string[]. 応答を指定したディメンションに限定します。省略すると、すべてのディメンションが返されます。
• --top integer, default 20. ディメンションごとに返す値の最大数です。残りは __other__ に合算されます。

例

# Break down Minecraft's recent reviews.
af reviews breakdown --filter-apps-by-id=ua_X7iNgb

# Where are Minecraft's biggest fans writing from?
af reviews breakdown --filter-apps-by-id=ua_X7iNgb --stars=5

# Count Minecraft's December 2025 5-star reviews.
af reviews breakdown --filter-apps-by-id=ua_X7iNgb --stars=5 --start=2025-12-01 --end=2025-12-31

# How many Minecraft reviewers raved?
af reviews breakdown --filter-apps-by-id=ua_X7iNgb --q='love amazing fun great best'

# Compare review volume across your own apps.
af reviews breakdown --filter-apps-by-source=own

---

af reviews reply

af reviews reply <review-id> [flags]

特定のレビューに対するデベロッパーの返信を投稿または取り下げます。投稿するには content を指定し、以前に投稿した返信を取り下げるには delete: true を指定します。

オプション

• <review-id> 必須の文字列。操作対象のレビューです。reviews list の review_id を使用します。
• --content 文字列。デベロッパーが公開する返信文です。
• --delete ブール値。このレビューに以前投稿した返信を取り下げます。content とは同時に指定できません。

使用例

# Reply to a low-star review after shipping a fix.
af reviews reply rev123 --content='We just shipped a fix in v2.1. Let us know if you still see this.'

# Withdraw a previously-posted response.
af reviews reply rev123 --delete

---

af keywords organic

af keywords organic [flags]

1 つ以上のアプリがオーガニック検索でランクインしているキーワードを、順位、人気度、競争度とともに確認します。

オプション

• --product-ids 整数の配列。プロダクト識別子（数値。各ストアフロントにつき 1 つ）。
• --countries 必須の文字列の配列。1 つ以上の ISO 国コード（例：US、JP、GB）。複数指定すると市場を比較できます。
• --device-type 文字列。デバイスの種類です。
• --count 整数、デフォルトは 10。返す結果の数（最小 10）。
• --page 整数、デフォルトは 1。ページ番号です。

使用例

# Check ChatGPT's current US keyword rankings.
af keywords organic --product-ids=336744124021 --countries=US

# Check ChatGPT's iPad-only keyword rankings.
af keywords organic --product-ids=336744124021 --countries=US --device-type=tablet

# Compare ChatGPT and Gemini's US keyword rankings.
af keywords organic --product-ids=336744124021,337217072531 --countries=US

---

af keywords paid

af keywords paid <product-ids> [flags]

1 つ以上のアプリが広告を掲載している有料キーワードを、インプレッションシェアとオーガニック検索順位とともに一覧表示します。

オプション

• <product-ids> 必須の整数の配列。プロダクト識別子（数値。各ストアフロントにつき 1 つ）。
• --days 整数、デフォルトは 180。遡る期間（日数）です。一般的な値：7、14、30、90、180、365。
• --countries 必須の文字列の配列。1 つ以上の ISO 国コード（例：US、JP、GB）。複数指定すると市場を比較できます。
• --device-types 文字列の配列。デバイスの種類で絞り込みます。デフォルトはハンドヘルドです。
• --count 整数、デフォルトは 10。返す結果の数（最小 10）。
• --page 整数、デフォルトは 1。ページ番号です。

使用例

# Find Headspace's US paid keywords.
af keywords paid 15250929 --countries=US

# Compare Headspace's and Calm's US paid keywords.
af keywords paid 15250929,304554144 --countries=US

# Find Headspace's paid keywords across the US, UK, and Japan.
af keywords paid 15250929 --countries=US,GB,JP

# Find Headspace's US iPad paid keywords.
af keywords paid 15250929 --countries=US --device-types=tablet

# Check Headspace's US paid keywords over the last 30 days.
af keywords paid 15250929 --countries=US --days=30

---

af keywords tracked-ranks

af keywords tracked-ranks <product-id> [flags]

1 つのアプリと国の組み合わせについて、追跡中のすべてのキーワードの順位を確認できます。各キーワードの現在の順位、前回変動してからの変化、開始時の順位、人気度、競争度が表示されます。

オプション

• <product-id> 必須の整数。1 つのストアフロントに対応する数値のプロダクト ID です。統合アプリ ID ではありません。メンバーの product_id 値は apps get '<unified-app-id>' から取得できます。
• --country 必須の文字列。ISO 国コード（例：US、JP、GB）。
• --device-type 文字列。順位を取得するデバイスです。省略するとストアのデフォルトが使用されます。
• --count 整数、デフォルトは 10。返す結果の数（最小 10）。
• --page 整数、デフォルトは 1。ページ番号です。
• --sort 文字列。結果の並べ替えに使うフィールドです。
• --order 文字列、デフォルトは desc。並べ替えの方向です。
• --start 文字列。期間の開始日（YYYY-MM-DD）。期間を省略すると直近 7 日間が対象になります。開始日の順位が開始時の順位の基準となります。
• --end 文字列。期間の終了日（YYYY-MM-DD、デフォルトは今日）。期間は最大 31 日間です。
• --keyword-term 文字列。このテキストを含む語句の追跡中キーワードのみを対象とします。
• --min-position 整数。対象に含める最高順位（1 = 1 位）。
• --max-position 整数。対象に含める最低順位です。
• --min-popularity 整数。対象に含める最低人気度（0～100）。
• --max-popularity 整数。対象に含める最高人気度（0～100）。
• --min-competitiveness 整数。対象に含める最低競争度（0～100）。
• --max-competitiveness 整数。対象に含める最高競争度（0～100）。

使用例

# Check how ChatGPT's tracked keywords are ranking.
af keywords tracked-ranks 336744124021 --country=US

# List ChatGPT's best-ranking keywords first.
af keywords tracked-ranks 336744124021 --country=US --sort=position --order=asc

# Show only the keywords ChatGPT ranks in the top 10.
af keywords tracked-ranks 336744124021 --country=US --max-position=10

# Find the most-searched keywords ChatGPT should prioritize.
af keywords tracked-ranks 336744124021 --country=US --sort=popularity --min-popularity=50

# Trace ChatGPT's keyword movement across a custom week.
af keywords tracked-ranks 336744124021 --country=US --start=2026-01-06 --end=2026-01-12

# Page through a long tracked keyword set.
af keywords tracked-ranks 336744124021 --country=US --page=2

---

af keywords tracked-trend

af keywords tracked-trend <keyword-id> [flags]

単一のアプリと国の組み合わせについて、追跡中のキーワードの順位が時間とともにどう変化するかを追跡します。各データポイントには順位と、直前のデータポイントからの順位変動数が含まれます。

オプション

• <keyword-id> 必須の文字列。追跡するキーワードです。このアプリと国で追跡されている必要があります。不透明な ID は keywords tracked-ranks または keywords tracked から取得できます。
• --product-id 必須の整数。1 つのストアフロントの数値の製品 ID です。統合アプリ ID ではありません。メンバーの product_id 値は apps get '<unified-app-id>' から取得できます。
• --country 必須の文字列。ISO 国コード（例：US、JP、GB）
• --device-type 文字列。順位を取得するデバイスです。省略すると、ストアのデフォルトが使用されます。
• --granularity 文字列。デフォルトは daily です。サンプリング間隔です。
• --start 文字列。期間の開始日（YYYY-MM-DD）です。省略すると、過去 7 日間が対象になります。
• --end 文字列。期間の終了日（YYYY-MM-DD。デフォルトは今日）です。時間単位の場合は最大 14 日間、日単位の場合は最大 31 日間です。

使用例

# Find a tracked keyword, then trace its rank day by day.
af keywords tracked-ranks 336744124021 --country=US
af keywords tracked-trend 00f2b1ead3a0990b818517356cb40280 --product-id=336744124021 --country=US

# Trace a keyword's rank for ChatGPT across a specific week.
af keywords tracked-trend 00f2b1ead3a0990b818517356cb40280 --product-id=336744124021 --country=US --start=2026-01-06 --end=2026-01-12

# Trace a keyword hour by hour.
af keywords tracked-trend 00f2b1ead3a0990b818517356cb40280 --product-id=336744124021 --country=US --granularity=hourly

---

af keywords suggestions

af keywords suggestions <product-id> [flags]

単一のアプリと国の組み合わせで、ターゲットとして検討できるキーワード候補を見つけます。アプリとの関連性順に並べられ、競合アプリから抽出された候補も含まれます。各候補には人気度、競争度、アプリの現在の順位が表示されます。

オプション

• <product-id> 必須の整数。1 つのストアフロントの数値の製品 ID です。統合アプリ ID ではありません。メンバーの product_id 値は apps get '<unified-app-id>' から取得できます。
• --country 必須の文字列。ISO 国コード（例：US、JP、GB）
• --device-type 文字列。順位を取得するデバイスです。省略すると、ストアのデフォルトが使用されます。
• --count 整数。デフォルトは 10 です。返す結果の数です。
• --page 整数。デフォルトは 1 です。ページ番号です。

使用例

# Discover keywords ChatGPT should consider targeting.
af keywords suggestions 336744124021 --country=US

# Find keyword ideas for ChatGPT in Japan.
af keywords suggestions 336744124021 --country=JP

# Pull a broader set of suggestions.
af keywords suggestions 336744124021 --country=US --count=50

---

af keywords ranking-apps

af keywords ranking-apps <keyword-term> [flags]

オーガニック検索で特定のキーワードに対して順位付けされているアプリと、そのキーワード自体の人気度および競争度のスコアを一覧表示します。

オプション

• <keyword-term> 必須の文字列。検索するキーワードです。
• --country 必須の文字列。ISO 国コード（例：US、JP、GB）
• --storefront 必須の文字列。アプリストアのプラットフォームです（例：apple:ios、google_play、amazon_appstore、steam、windows10、apple:mac、apple:tv、apple:imessage、またはその他の対応ストアフロント）。
• --device-type 文字列。デバイスの種類です。
• --count 整数。デフォルトは 10 です。返す結果の数です。
• --page 整数。デフォルトは 1 です。ページ番号です。

使用例

# Find US iOS apps ranking for "fitness".
af keywords ranking-apps fitness --country=US --storefront=apple:ios

# Find Google Play apps ranking for "fitness".
af keywords ranking-apps fitness --country=US --storefront=google_play

# Find US iPad apps ranking for "meditation".
af keywords ranking-apps meditation --country=US --storefront=apple:ios --device-type=tablet

---

af keywords advertisers

af keywords advertisers <keyword-term> [flags]

特定のキーワードに広告を掲載しているアプリを、それぞれの広告主のインプレッションシェア、オーガニック順位、入札継続期間とともに一覧表示します。

オプション

• <keyword-term> 必須の文字列。広告主を検索するキーワードです。
• --days 整数。デフォルトは 180 です。遡る期間の日数です。一般的な値：7、14、30、90、180、365。
• --country 必須の文字列。ISO 国コード（例：US、JP、GB）
• --device-type 文字列。デバイスの種類です。
• --count 整数。デフォルトは 10 です。返す結果の数です。
• --page 整数。デフォルトは 1 です。ページ番号です。

使用例

# Find US apps advertising on the "notion" brand.
af keywords advertisers notion --country=US

# Find US iPad apps advertising on "meditation".
af keywords advertisers meditation --country=US --device-type=tablet

# Find US apps advertising on "fitness" over the last 30 days.
af keywords advertisers fitness --country=US --days=30

---

af keywords related

af keywords related <keyword-term> [flags]

ASO 調査のため、シード語に関連するキーワードを見つけます。類似したオーディエンスを持ち、より人気がある、または競争が少ない代替候補を探すのに役立ちます。

オプション

• <keyword-term> 必須の文字列。関連語を見つけるシードキーワード。
• --country 必須の文字列。ISO 国コード（例：US、JP、GB）
• --storefront 必須の文字列。アプリストアのプラットフォーム（例：apple:ios、google_play、amazon_appstore、steam、windows10、apple:mac、apple:tv、apple:imessage、またはその他の対応ストアフロント）。
• --device-type 文字列。デバイスの種類
• --count 整数、デフォルトは 10。返す結果の数。
• --page 整数、デフォルトは 1。ページ番号。

例

# Find US iOS keywords related to "fitness".
af keywords related fitness --country=US --storefront=apple:ios

# Find US Google Play keywords related to "fitness".
af keywords related fitness --country=US --storefront=google_play

# Find US iPad keywords related to "meditation".
af keywords related meditation --country=US --storefront=apple:ios --device-type=tablet

---

af keywords tracked

af keywords tracked [flags]

トラッキング中のキーワードを、不透明な ID とともに一覧表示します。

オプション

• --count 整数、デフォルトは 10。返す結果の数。
• --page 整数、デフォルトは 1。ページ番号。
• --q 文字列。keyword_term で絞り込みます。
• --sort 文字列。並べ替えに使うフィールド。指定しない場合、q が設定されていれば関連度順、それ以外の場合はリスト順になります。
• --order 文字列、デフォルトは desc。並べ替え順。
• --include-relationships ブール値、デフォルトは false。各行に商品と国の組み合わせごとのトラッキング詳細と同期状態を含めます。デフォルトでは無効です。有効にすると、トラッキング中の商品と国の各組み合わせに対する入れ子のブロックが追加されます。

例

# List every tracked keyword.
af keywords tracked

# Search tracked keywords for "fitness".
af keywords tracked --q=fitness

# List the most-recently-tracked keywords first.
af keywords tracked --sort=added_on

# Show each keyword's tracking and sync detail.
af keywords tracked --include-relationships

---

af keywords track

af keywords track <keyword-term> [flags]

キーワードをトラッキングして、アプリの順位を時間の経過とともに毎時監視し、順位が変動したときに自動アラートを受け取ります。

オプション

• <keyword-term> 必須の文字列。トラッキングを開始するキーワード
• --product-id 必須の整数。キーワードをトラッキングするアプリの商品 ID
• --country 必須の文字列。ISO 国コード（例：US、JP、GB）

例

# Start tracking "meditation" for one of your apps in the US.
af keywords track meditation --product-id=336744124021 --country=US

# Track "workout" in Japan.
af keywords track workout --product-id=336744124021 --country=JP

---

af keywords untrack

af keywords untrack <keyword-id>

キーワードのトラッキングを停止します。

オプション

• <keyword-id> 必須の文字列。トラッキング中のキーワード行の識別子（keywords tracked が返すもの）。キーワードのテキストではありません。

例

# Stop tracking a keyword.
af keywords untrack a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

---

af apple-ads organizations

af apple-ads organizations [flags]

キャンペーンを管理している Apple Ads 組織を、それぞれの通貨とタイムゾーンとともに一覧表示します。

オプション

• --count 整数、デフォルトは 10。返す結果の数。
• --page 整数、デフォルトは 1。ページ番号。

例

# List all the Apple Ads organizations you manage.
af apple-ads organizations

---

af apple-ads campaigns

af apple-ads campaigns [flags]

Apple Ads キャンペーンを、それぞれのステータス、予算、ターゲット国、スケジュールとともに一覧表示します。

オプション

• --display-status 文字列。指定したステータスのキャンペーンに絞り込みます。指定しない場合、すべてのステータスが含まれます。
• --name 文字列。名前にこのテキストを含むキャンペーンに絞り込みます。
• --countries 文字列[]。指定した国のいずれかをターゲットとするキャンペーンに絞り込みます。
• --count 整数、デフォルトは 10。返す結果の数。
• --page 整数、デフォルトは 1。ページ番号。

例

# List all your Apple Ads campaigns.
af apple-ads campaigns

# List only your running campaigns.
af apple-ads campaigns --display-status=running

# Search your campaigns by name.
af apple-ads campaigns --name=Brand

# List campaigns targeting the US or UK.
af apple-ads campaigns --countries=US,GB

---

af apple-ads ad-groups

af apple-ads ad-groups [campaign-id] [flags]

Apple Ads の広告グループを一覧表示します。各広告グループのデフォルト入札額、CPA 上限、料金モデル、スケジュールも表示します。

オプション

• [campaign-id] 文字列。1 つのキャンペーン内の広告グループに絞り込みます。
• --display-status 文字列。1 つのステータスの広告グループに絞り込みます。すべてのステータスを含める場合は省略します。
• --name 文字列。名前にこの部分文字列を含む広告グループに絞り込みます。
• --count 整数。デフォルトは 10 です。返す結果の数です。
• --page 整数。デフォルトは 1 です。ページ番号です。

使用例

# List all your ad groups across every campaign.
af apple-ads ad-groups

# List the ad groups in one campaign.
af apple-ads ad-groups aac_W9YthU

---

af apple-ads keywords

af apple-ads keywords <campaign-id> [flags]

キャンペーンの入札キーワードを一覧表示します。各キーワードの指定期間におけるパフォーマンス（インプレッション数、タップ数、インストール数、消化金額、インストール単価）に加え、マッチタイプ、入札額、ターゲティング語句か除外語句かも表示します。

オプション

• <campaign-id> 必須の文字列。入札キーワードを一覧表示するキャンペーンです。
• --ad-group-id 文字列。1 つの広告グループ内のキーワードに絞り込みます。
• --status 文字列。1 つのステータスのキーワードに絞り込みます。すべてのステータスを含める場合は省略します。
• --match-type 文字列。1 つのマッチタイプに絞り込みます。両方を含める場合は省略します。
• --name 文字列。テキストにこの部分文字列を含むキーワードに絞り込みます。
• --sort 文字列。パフォーマンス指標または入札額でキーワードを並べ替えます。新しいものから表示する場合は省略します。
• --order 文字列。デフォルトは desc です。並べ替え順です。
• --start 文字列。開始日（YYYY-MM-DD）
• --end 文字列。終了日（YYYY-MM-DD。デフォルトは今日）
• --count 整数。デフォルトは 10 です。返す結果の数です。
• --page 整数。デフォルトは 1 です。ページ番号です。

使用例

# Find a running campaign, then list its bid keywords.
af apple-ads campaigns --display-status=running
af apple-ads keywords aac_W9YthU

# See how a campaign's keywords performed over July 2026.
af apple-ads keywords aac_W9YthU --start=2026-07-01 --end=2026-07-31

# Find a campaign's highest-spending keywords.
af apple-ads keywords aac_W9YthU --sort=spend

---

af apple-ads search-terms

af apple-ads search-terms <campaign-id> [flags]

キャンペーンの広告表示につながった実際のユーザー検索語句を一覧表示します。各検索語句について、全期間のパフォーマンス（インプレッション数、タップ数、インストール数、消化金額、インストール単価）も表示します。これらを使って、入札対象にする新しいキーワードや除外するキーワードを見つけられます。

オプション

• <campaign-id> 必須の文字列。一覧表示する検索語句のキャンペーンです。
• --count 整数。デフォルトは 10 です。返す結果の数です。
• --page 整数。デフォルトは 1 です。ページ番号です。

使用例

# Find a campaign, then see the user searches that triggered its ads.
af apple-ads campaigns
af apple-ads search-terms aac_uDGL4v

---

af apple-ads report

af apple-ads report [flags]

指定期間のキャンペーンごとの Apple Ads パフォーマンス（インプレッション数、タップ数、インストール数、消化金額、インストール単価）と、アカウント全体の合計をレポートします。

オプション

• --campaign-ids string[]。レポートを特定のキャンペーンに限定します。
• --start 文字列。開始日（YYYY-MM-DD）
• --end 文字列。終了日（YYYY-MM-DD。デフォルトは今日）
• --count 整数。デフォルトは 10 です。返す結果の数です。
• --page 整数。デフォルトは 1 です。ページ番号です。

使用例

# See how much an install costs across all your campaigns.
af apple-ads report

# Report on July 2026 performance.
af apple-ads report --start=2026-07-01 --end=2026-07-31

# List campaigns, then report on specific ones.
af apple-ads campaigns
af apple-ads report --campaign-ids=aac_uDGL4v

---

af apple-ads top-keywords

af apple-ads top-keywords <campaign-id> [flags]

指定期間のコンバージョン率、消化金額、インストール数で、キャンペーンの上位パフォーマンスのキーワードをランク付けします。各リストには、1 つの指標における上位キーワードが表示されます。

オプション

• <campaign-id> 必須の文字列。キーワードをランク付けするキャンペーンです。
• --top 整数。デフォルトは 5 です。ランキングごとに返すキーワードの数です（最大 10）。
• --start 文字列。開始日（YYYY-MM-DD）
• --end 文字列。終了日（YYYY-MM-DD。デフォルトは今日）

使用例

# Find a campaign, then see its top-performing keywords.
af apple-ads campaigns
af apple-ads top-keywords aac_uDGL4v

# Rank a campaign's keywords for a specific week.
af apple-ads top-keywords aac_uDGL4v --start=2026-07-25 --end=2026-07-31

# Widen each ranking to the maximum of 10 keywords.
af apple-ads top-keywords aac_uDGL4v --top=10

---

af sdks list

af sdks list [flags]

既知のすべての SDK を ID とともに一覧表示するか、検索して特定の SDK を見つけます。

オプション

• --count 整数、デフォルトは 50。返す結果の数です。
• --page 整数、デフォルトは 1。ページ番号です。
• --q 文字列。name、description、tags で絞り込みます。
• --sort 文字列。並べ替えるフィールドです。省略すると、q が指定されている場合は関連度順、それ以外の場合は一覧順になります。
• --order 文字列、デフォルトは desc。並べ替え順です。
• --sdk-id 文字列[]。指定した SDK ID のみを返します。
• --include-inactive boolean、デフォルトは false。無効な SDK を含めます。これはまれなケースです。ほとんどの場合、有効な SDK のみが必要です。

例

# Find OneSignal's id.
af sdks list --q=OneSignal

# Search for analytics SDKs.
af sdks list --q=analytics

# Look up details for several SDK ids.
af sdks list --sdk-id=firebase,admob,onesignal

# Include inactive SDKs in the listing (not common).
af sdks list --include-inactive

---

af docs get

af docs get <slug>

slug を指定して、リファレンスドキュメントまたはガイドを返します。

オプション

• <slug> 必須の文字列。返すリファレンスを指定します

例

# Read the dataset naming conventions and pitfalls for [`metrics query`](#command-metrics-query); the dataset list itself is in [`metrics describe-datasets`](#command-metrics-describe-datasets).
af docs get numeric_metrics

# Read the catalog query grammar, field-reference syntax, aggregation rules, and worked queries for [`explorer list-products`](#command-explorer-list-products) and [`explorer aggregate-products`](#command-explorer-aggregate-products).
af docs get catalog_playbook

# Read the glossary of domain terms seen in responses.
af docs get glossary

---

af api

af api <path> [flags]

専用のコマンドがないエンドポイントに対して、未加工の API リクエストを実行します。エンドポイント、パラメーター、レスポンス形式は https://docs.appfigures.com に記載されています。

オプション

• <path> 必須の文字列。API パス（例：/users、/products）
• --method 文字列、デフォルトは GET。HTTP メソッド（次のいずれか：GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS）
• --body 文字列。リクエスト本文（JSON 文字列）

---

af mcp

af mcp

（非推奨）ローカルの MCP サーバーを stdio 経由で実行します。代わりに、ホスト型の Appfigures MCP サーバーを使用してください：https://mcp.appfigures.com/mcp

---

af auth login

af auth login [flags]

Appfigures にサインインします

この CLI を認証するための URL を表示します。URL を開いてアクセスを承認した後、承認後に表示されるコードを使って --code <code> を指定し、再実行します。代わりに、--interactive を指定すると、ガイド付きブラウザーフローでサインインできます。

対話操作を行わない用途（CI、スクリプト）では、代わりに環境変数 APPFIGURES_API_KEY を設定してください。ブラウザーフローは不要です。

オプション

• --code 文字列。OAuth 同意ページで取得した認証コードです。af auth login の第 2 ステップとして、コードを交換してトークンを保存し、終了します。
• --interactive boolean。ガイド付きブラウザーフローでサインインします。

---

af auth logout

af auth logout

保存済みの認証情報を削除します

---

af auth status

af auth status

認証とアカウントの状態を表示します

サポート

• 問題： github.com/appfigures/cli/issues
• API ドキュメント： docs.appfigures.com

コントリビューション

このパッケージはプライベートなモノレポで開発され、ミラーとしてここで公開されています。バグの報告や機能のリクエストは、issue を作成してください。

AI を活用した開発に取り組む開発者も募集しています。AI App Intelligence の未来を一緒に築きたい方は、appfigures.com/careers からご応募ください。

ライセンス

Apache 2.0