Appfigures

@appfigures/cli

The Appfigures CLI — query app metrics, reviews, and store data from your terminal.

Try it now without installing:

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

Install

npm install -g @appfigures/cli

Requires Node.js 22+. Works with pnpm and yarn too.

Quick start

appfigures auth login
appfigures --help

Also available as af alias.

Authentication

• Log in yourself. af auth login --interactive opens your browser in a guided flow; approve and paste the code back.
• Or let your agent guide you. By default, af auth login prints an authorization URL — open it, approve, and finish with af auth login --code using the code shown. An agent can drive this end to end. For unattended use, set APPFIGURES_API_KEY instead: create a token at appfigures.com/developers/keys by clicking Create a New Client, then Create Personal Access Token.

Either login saves the token to your OS credential manager (macOS Keychain, Windows Credential Manager, Linux Secret Service). See Environment for APPFIGURES_API_KEY and other overrides.

MCP server

af mcp runs a local Model Context Protocol server over stdio, exposing the CLI's app-intelligence commands as MCP tools. Point any MCP client (Claude Code, Claude Desktop, Cursor, and others) at it to let an agent query app metrics, reviews, and store data directly.

Add it to your client's MCP config:

{
	"mcpServers": {
		"appfigures": {
			"command": "npx",
			"args": ["-y", "@appfigures/cli", "mcp"]
		}
	}
}

The server signs in with your stored credentials, so run af auth login once first. For a headless setup, pass a token through the client's env instead:

{
	"mcpServers": {
		"appfigures": {
			"command": "npx",
			"args": ["-y", "@appfigures/cli", "mcp"],
			"env": { "APPFIGURES_API_KEY": "<your-token>" }
		}
	}
}

Installed the CLI globally instead of running it through npx? Use "command": "af" with "args": ["mcp"].

Claude Code. Add it with one command:

claude mcp add appfigures -- npx -y @appfigures/cli mcp

Run af auth login first to sign in, or append --env APPFIGURES_API_KEY=<your-token> for a headless setup.

Commands

Apps

Find apps and look up their identity. Other commands take the app IDs these return.

Explorer

Search and analyze the full app catalog: millions of products across Apple, Google Play, Amazon, and other major stores, with 120+ fields spanning identity, storefront and country availability, categories, ratings, release dates, chart ranks, download and revenue estimates, SDK presence, demographics, and related apps.

Metrics

Query numeric datasets across dimensions.

Store

App store presence: listing content, category ranks, top charts, and featured placements.

Audience

Who an app's users are and what else they use. Covers estimated age and gender, plus audience overlap with other apps.

Reviews

Search, summarize, and reply to iOS and Google Play app store reviews.

Keywords

Keyword visibility, rank tracking, and discovery across organic search (App Store, Google Play) and Apple Ads.

Apple Ads

Manage your Apple Ads campaigns, ad groups, keywords, and performance.

Sdks

Look up the SDKs we track.

Docs

Reference docs and guides for specific actions and common tasks.

API

MCP

Auth

Run af <command> --help for arguments, flags, and examples.

Environment

API Reference

Every command with its full argument and flag list. For the one-line overview, see Commands above.

Global flags. All commands accept:

• -v, --verbose — Log HTTP requests to stderr. Also set via AF_VERBOSE=1.
• -V, --version — Print the CLI version and exit.
• -h, --help — Show usage for the current command.

Output format. Every command emits a single JSON value on stdout — pipe to jq for filtering. Informational messages, hints, and update notices go to stderr so pipelines stay clean.

af apps search

af apps search <q> [flags]

Find apps by name or publisher. Returns one row per unified app. Default returns Apple and Google listings; pass --all-stores to include other storefronts. To filter apps by estimate values (e.g. apps with >100k downloads last month) use explorer list-products. For estimates broken down by time, country, or storefront, use metrics query with datasets estimates.sales or estimates.revenue.

Options

• <q> required string. Search query (app name or publisher).
• --all-stores boolean, default false. Include storefronts beyond Apple and Google: Amazon, Windows, Steam, Roku, LG TV, Samsung TV, and others.
• --count integer, default 10. Number of results to return.
• --page integer, default 1. Page number.

Examples

# 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 tracked

af apps tracked [flags]

List the apps your Appfigures account tracks.

Options

• --count integer, default 10. Number of results to return.
• --page integer, default 1. Page number.
• --q string. App name to filter by.
• --filter-apps-by-id (integer or string)[]. Only include data about specific apps, by product ID or unified app ID. Takes precedence over the other filterAppsBy* keys when set. Storefront, source, or type filters are better for app sets that can be described by those criteria.
• --filter-apps-by-storefront string[]. Narrow the account's tracked apps to those on these storefronts (e.g. apple:ios, google_play).
• --filter-apps-by-source string[]. Narrow the account's tracked apps by tracking relationship.
• --filter-apps-by-type string[]. Narrow the account's tracked apps to products of these types.

Examples

# 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 get

af apps get <app-id> [flags]

Get an app's record: basic metadata (name, developer, etc) and, if the user tracks it, what data they can access. Pass a product ID for one storefront; unified app ID for all storefronts together.

Options

• <app-id> required integer or string. The app's unified app ID or product ID.
• --all-stores boolean, default false. For a unified app ID: include member products across all storefronts (Amazon, Steam, Windows, Roku, etc.). When false, member_products is restricted to storefronts with app-intelligence coverage (iOS + Google Play). Ignored for product IDs.

**