@appfigures/cli

Die Appfigures-CLI – fragen Sie App-Metriken, Bewertungen und Store-Daten von Ihrem Terminal ab.

Jetzt ohne Installation ausprobieren:

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

Install

npm install -g @appfigures/cli

Erfordert Node.js 22+. Funktioniert auch mit pnpm und yarn.

Related MCP server: asc-mcp

Quick start

appfigures auth login
appfigures --help

Auch als af-Alias verfügbar.

Authentication

• Melden Sie sich selbst an. af auth login --interactive öffnet Ihren Browser in einem geführten Ablauf; bestätigen Sie und fügen Sie den Code wieder ein.

• Oder lassen Sie sich von Ihrem Agenten führen. Standardmäßig gibt af auth login eine Autorisierungs-URL aus – öffnen Sie sie, bestätigen Sie und schließen Sie mit af auth login --code <code> ab, wobei Sie den angezeigten Code verwenden. Ein Agent kann dies vollständig steuern. Für unbeaufsichtigte Nutzung setzen Sie stattdessen APPFIGURES_API_KEY: Erstellen Sie unter appfigures.com/developers/keys ein Token, indem Sie auf Create a New Client und dann auf Create Personal Access Token klicken.

Beide Anmeldemethoden speichern das Token in Ihrem Betriebssystem-Schlüsselbund (macOS Keychain, Windows Credential Manager, Linux Secret Service). Siehe Environment für APPFIGURES_API_KEY und andere Überschreibungen.

MCP server

af mcp führt einen lokalen Model Context Protocol-Server über stdio aus und stellt die App-Intelligence-Befehle der CLI als MCP-Tools bereit. Richten Sie einen beliebigen MCP-Client (Claude Code, Claude Desktop, Cursor und andere) darauf aus, damit ein Agent App-Metriken, Bewertungen und Store-Daten direkt abfragen kann.

Fügen Sie es zur MCP-Konfiguration Ihres Clients hinzu:

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

Der Server meldet sich mit Ihren gespeicherten Anmeldedaten an. Führen Sie daher zuerst einmal af auth login aus. Für eine Headless-Einrichtung übergeben Sie stattdessen ein Token über die env-Umgebung des Clients:

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

Haben Sie die CLI global installiert, statt sie über npx auszuführen? Verwenden Sie "command": "af" mit "args": ["mcp"].

Claude Code. Fügen Sie es mit einem Befehl hinzu:

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

Führen Sie zuerst af auth login aus, um sich anzumelden, oder hängen Sie für eine Headless-Einrichtung --env APPFIGURES_API_KEY=<your-token> an.

Commands

Apps

Finden Sie Apps und schlagen Sie ihre Identität nach. Andere Befehle verwenden die App-IDs, die diese zurückgeben.

Explorer

Durchsuchen und analysieren Sie den vollständigen App-Katalog: Millionen von Produkten in Apple, Google Play, Amazon und anderen großen Stores, mit über 120 Feldern, die Identität, Storefront- und Länderverfügbarkeit, Kategorien, Bewertungen, Veröffentlichungsdaten, Chart-Ränge, Download- und Umsatzschätzungen, SDK-Präsenz, Demografie und verwandte Apps abdecken.

Metrics

Fragen Sie numerische Datensätze über Dimensionen hinweg ab.

Store

App-Store-Präsenz: Listing-Inhalte, Kategorie-Ränge, Top-Charts und Featured-Platzierungen.

Zielgruppe

Wer die Nutzer einer App sind und was sie sonst noch verwenden. Umfasst geschätztes Alter und Geschlecht sowie die Überschneidung der Zielgruppe mit anderen Apps.

Bewertungen

Durchsuchen, zusammenfassen und beantworten Sie iOS- und Google-Play-App-Store-Bewertungen.

Schlüsselwörter

Sichtbarkeit von Schlüsselwörtern, Ranking-Tracking und Entdeckung über organische Suche (App Store, Google Play) und Apple Ads.

Apple Ads

Verwalten Sie Ihre Apple-Ads-Kampagnen, Anzeigengruppen, Schlüsselwörter und Leistung.

SDKs

Schlage die SDKs nach, die wir verfolgen.

Dokumentation

Referenzdokumente und Anleitungen für bestimmte Aktionen und häufige Aufgaben.

API

MCP

Authentifizierung

Führe af <command> --help für Argumente, Flags und Beispiele aus.

Umgebung

API-Referenz

Jeder Befehl mit seiner vollständigen Argument- und Flag-Liste. Für die einzeilige Übersicht siehe Commands oben.

Globale Flags. Alle Befehle akzeptieren:

• -v, --verbose — HTTP-Anfragen in stderr protokollieren. Auch über AF_VERBOSE=1 setzbar.

• -V, --version — CLI-Version ausgeben und beenden.

• -h, --help — Verwendung für den aktuellen Befehl anzeigen.

Ausgabeformat. Jeder Befehl gibt einen einzelnen JSON-Wert auf stdout aus — für Filterung an jq weiterreichen. Informationsmeldungen, Hinweise und Update-Benachrichtigungen gehen an stderr, damit Pipelines sauber bleiben.

af apps search

af apps search <q> [flags]

Finde Apps nach Name oder Publisher. Gibt eine Zeile pro vereinheitlichter App zurück. Standardmäßig werden Apple- und Google-Einträge zurückgegeben; übergib --all-stores, um andere Storefronts einzuschließen. Um Apps nach Schätzwerten zu filtern (z. B. Apps mit >100k Downloads im letzten Monat), verwende explorer list-products. Für Schätzungen nach Zeit, Land oder Storefront verwende metrics query mit den Datasets estimates.sales oder estimates.revenue.

Optionen

• <q> erforderliche Zeichenfolge. Suchanfrage (App-Name oder Publisher).

• --all-stores boolesch, Standard false. Storefronts außer Apple und Google einschließen: Amazon, Windows, Steam, Roku, LG TV, Samsung TV und andere.

• --count Ganzzahl, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard 1. Seitennummer.

Beispiele

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

Liste die Apps auf, die dein Appfigures-Konto verfolgt.

Optionen

• --count Ganzzahl, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard 1. Seitennummer.

• --q Zeichenfolge. App-Name, nach dem gefiltert werden soll.

• --filter-apps-by-id (Ganzzahl oder Zeichenfolge)[]. Nur Daten über bestimmte Apps einschließen, nach Produkt-ID oder vereinheitlichter App-ID. Hat Vorrang vor den anderen filterAppsBy*-Schlüsseln, wenn gesetzt. Storefront-, Quellen- oder Typ-Filter sind besser für App-Sets, die durch diese Kriterien beschrieben werden können.

• --filter-apps-by-storefront Zeichenfolge[]. Die verfolgten Apps des Kontos auf diejenigen in diesen Storefronts eingrenzen (z. B. apple:ios, google_play).

• --filter-apps-by-source Zeichenfolge[]. Die verfolgten Apps des Kontos nach Tracking-Beziehung eingrenzen.

• --filter-apps-by-type Zeichenfolge[]. Die verfolgten Apps des Kontos auf Produkte dieser Typen eingrenzen.

Beispiele

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

Rufe den Datensatz einer App ab: grundlegende Metadaten (Name, Entwickler, usw.) und, falls der Nutzer sie verfolgt, welche Daten er abrufen kann. Übergib eine Produkt-ID für eine Storefront; die vereinheitlichte App-ID für alle Storefronts zusammen.

Optionen

• <app-id> erforderliche Ganzzahl oder Zeichenfolge. Die vereinheitlichte App-ID oder Produkt-ID der App.

• --all-stores boolesch, Standard false. Für eine vereinheitlichte App-ID: Mitgliedsprodukte über alle Storefronts einschließen (Amazon, Steam, Windows, Roku, etc.). Bei false ist member_products auf Storefronts mit App-Intelligence-Abdeckung (iOS + Google Play) beschränkt. Wird bei Produkt-IDs ignoriert.

Beispiele

# 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 explorer list-products

af explorer list-products [flags]

Lies Katalogfelder für eine App oder viele. Felder, auf die query oder sort verweisen, werden automatisch zurückgegeben; übergib --extra-fields für weitere. Verwende ["match","product_id",<id>] für eine einzelne App oder kombiniere Filter für Populationsabfragen (z. B. iOS-Apps mit Firebase und 1 Mio+ US-Umsatz). Die 120+ Felder umfassen Ränge, Bewertungen, Download- und Umsatzschätzungen, SDKs, Demografie und mehr; Abfragegrammatik und Feldliste in docs get catalog_playbook.

Optionen

• --query Array, Standard []. Explorer-Abfrage im JSON-Array-Format, um passende Katalog-Produkte auszuwählen. Fehlende Werte und [] entsprechen jedem Produkt über jede Storefront. Die vollständige Feldliste und Abfragesyntax sind in docs get catalog_playbook dokumentiert.

• --extra-fields Zeichenfolge[]. Zusätzliche Felder, die über die hinausgehen, die deine query oder sort bereits referenzieren. Finde Feldpfade (und welche du lesen kannst) mit explorer describe-fields.

• --sort Zeichenfolge. Explorer-Feldname. Die vollständige Feldliste ist in docs get catalog_playbook dokumentiert.

• --order Zeichenfolge, Standard desc. Sortierrichtung.

• --count Ganzzahl, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard 1. Seitennummer.

• --allow-unscoped-nested boolesch, Standard false. Escape-Hatch für absichtlich breite Abfragen. Umgeht die Standardblockierung auf unbegrenzte verschachtelte Prädikate, die normalerweise Ergebnisse aufblähen.

Beispiele

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

Aggregiere über den vollständigen Katalog von Millionen von Produkten über Apple, Google Play, Amazon und andere große Stores: Zählungen, Durchschnittswerte, Min/Max und Histogramme über jede Menge von passenden Produkten. Verwendet dieselbe Abfragegrammatik wie explorer list-products; gibt Aggregate statt Produktdatensätze zurück. Für Marktgrößenbestimmung, Benchmarking und Segmentanalyse.

Optionen| Befehl | Beschreibung | | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | af apple-ads organizations | Liste die Apple-Ads-Organisationen auf, in denen du Kampagnen verwaltest, jeweils mit Währung und Zeitzone. | | af apple-ads campaigns | Liste deine Apple-Ads-Kampagnen auf, jeweils mit Status, Budget, Zielländern und Zeitplan. | | af apple-ads ad-groups | Liste Apple-Ads-Anzeigengruppen auf, jeweils mit Standard-Gebot, CPA-Obergrenze, Preismodell und Zeitplan. | | af apple-ads keywords | Liste die Gebots-Keywords einer Kampagne auf, jeweils mit Leistung (Impressionen, Taps, Installationen, Ausgaben, Kosten pro Installation) über einen Datumsbereich, plus Match-Typ, Gebot und ob es sich um einen Targeting- oder Negativbegriff handelt. | | af apple-ads search-terms | Liste die tatsächlichen Suchbegriffe der Nutzer auf, die Anzeigen einer Kampagne ausgelöst haben, jeweils mit Gesamtleistung (Impressionen, Taps, Installationen, Ausgaben, Kosten pro Installation). Nutze diese, um neue Keywords zum Bieten oder Ausschließen zu entdecken. | | af apple-ads report | Meldet die Apple-Ads-Leistung pro Kampagne (Impressionen, Taps, Installationen, Ausgaben, Kosten pro Installation) sowie eine kontoweite Summe über einen Datumsbereich. | | af apple-ads top-keywords | Ordne die leistungsstärksten Keywords einer Kampagne nach Conversion-Rate, Ausgaben und Installationen über einen Datumsbereich. Jede Liste enthält die Top-Keywords je einer Kennzahl. |

SDKs

Schlage die SDKs nach, die wir verfolgen.

Dokumentation

Referenzdokumente und Anleitungen für bestimmte Aktionen und häufige Aufgaben.

API

MCP

Authentifizierung

Führe af <command> --help für Argumente, Flags und Beispiele aus.

Umgebung

API-Referenz

Jeder Befehl mit seiner vollständigen Argument- und Flag-Liste. Für die einzeilige Übersicht siehe Commands oben.

Globale Flags. Alle Befehle akzeptieren:

• -v, --verbose – HTTP-Anfragen in stderr protokollieren. Auch über AF_VERBOSE=1 setzbar.

• -V, --version – CLI-Version ausgeben und beenden.

• -h, --help – Verwendung für den aktuellen Befehl anzeigen.

Ausgabeformat. Jeder Befehl gibt einen einzelnen JSON-Wert auf stdout aus – für Filterung an jq weiterreichen. Informationsmeldungen, Hinweise und Update-Benachrichtigungen gehen an stderr, damit Pipelines sauber bleiben.

af apps search

af apps search <q> [flags]

Finde Apps nach Name oder Publisher. Gibt eine Zeile pro vereinheitlichter App zurück. Standardmäßig werden Apple- und Google-Einträge zurückgegeben; übergib --all-stores, um andere Storefronts einzuschließen. Um Apps nach Schätzwerten zu filtern (z. B. Apps mit >100k Downloads im letzten Monat) verwende explorer list-products. Für Schätzungen nach Zeit, Land oder Storefront verwende metrics query mit den Datasets estimates.sales oder estimates.revenue.

Optionen

• <q> erforderliche Zeichenfolge. Suchanfrage (App-Name oder Publisher).

• --all-stores boolesch, Standard false. Storefronts außer Apple und Google einschließen: Amazon, Windows, Steam, Roku, LG TV, Samsung TV und andere.

• --count Ganzzahl, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard 1. Seitennummer.

Beispiele

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

Liste die Apps auf, die dein Appfigures-Konto verfolgt.

Optionen

• --count Ganzzahl, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard 1. Seitennummer.

• --q Zeichen. App-Name, nach dem gefiltert werden soll.

• --filter-apps-by-id (Ganzzahl oder Zeichen)[]. Nur Daten über bestimmte Apps einschließen, nach Produkt-ID oder vereinheitlichter App-ID. Hat Vorrang vor den anderen filterAppsBy*-Schlüsseln, wenn gesetzt. Storefront-, Quellen- oder Typ-Filter sind besser für App-Sets, die durch diese Kriterien beschrieben werden können.

• --filter-apps-by-storefront Zeichen[]. Die verfolgten Apps des Kontos auf diejenigen in diesen Storefronts eingrenzen (z. B. apple:ios, google_play).

• --filter-apps-by-source Zeichen[]. Die verfolgten Apps des Kontos nach Tracking-Beziehung eingrenzen.

• --filter-apps-by-type Zeichen[]. Die verfolgten Apps des Kontos auf Produkte dieser Typen eingrenzen.

Beispiele

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

Rufe den Datensatz einer App ab: grundlegende Metadaten (Name, Entwickler, usw.) und, falls der Nutzer sie verfolgt, welche Daten er abrufen kann. Übergib eine Produkt-ID für eine Storefront; die vereinheitlichte App-ID für alle Storefronts zusammen.

Optionen

• <app-id> erforderliche Ganzzahl oder Zeichen. Die vereinheitlichte App-ID oder Produkt-ID der App.

• --all-stores boolesch, Standard false. Für eine vereinheitlichte App-ID: Mitgliedsprodukte über alle Storefronts einschließen (Amazon, Steam, Windows, Roku, usw.). Bei false ist member_products auf Storefronts mit App-Intelligence-Abdeckung (iOS + Google Play) beschränkt. Wird bei Produkt-IDs ignoriert.

Beispiele

# 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 explorer list-products

af explorer list-products [flags]

Lies Katalogfelder für eine App oder viele. Felder, auf die query oder sort verweisen, werden automatisch zurückgegeben; übergib --extra-fields für weitere. Verwende ["match","product_id",<id>] für eine einzelne App oder kombiniere Filter für Populationsabfragen (z. B. iOS-Apps mit Firebase und 1M+ US-Umsatz). Die 120+ Felder umfassen Ränge, Bewertungen, Download- und Umsatzschätzungen, SDKs, Demografie und mehr; Abfragegrammatik und Feldliste in docs get catalog_playbook.

Optionen

• --query Array, Standard []. Explorer-Abfrage im JSON-Array-Format, um passende Katalog-Produkte auszuwählen. Fehlende Werte und [] entsprechen jedem Produkt über jede Storefront. Die vollständige Feldliste und Abfragesyntax sind in docs get catalog_playbook dokumentiert.

• --extra-fields Zeichen[]. Zusätzliche Felder, die über die hinausgehen, die deine query oder sort bereits referenzieren. Finde Feldpfade (und welche du lesen kannst) mit explorer describe-fields.

• --sort Zeichen. Explorer-Feldname. Die vollständige Feldliste ist in docs get catalog_playbook dokumentiert.

• --order Zeichen, Standard desc. Sortierrichtung.

• --count Ganzzahl, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard 1. Seitennummer.

• --allow-unscoped-nested boolesch, Standard false. Escape-Hatch für absichtlich breite Abfragen. Umgeht die Standardblockierung auf unbegrenzte verschachtelte Prädikate, die normalerweise Ergebnisse aufblähen.

Beispiele

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

Aggregiere über den vollständigen Katalog von Millionen von Produkten über Apple, Google Play, Amazon und andere große Stores: Zählungen, Durchschnittswerte, Min/Max und Histogramme über jede Menge von passenden Produkten. Verwendet dieselbe Abfragegrammatik wie explorer list-products; gibt Aggregate statt Produktdatensätze zurück. Für Marktgrößenbestimmung, Benchmarking und Segmentanalyse.

Optionen

• <fields> erforderlich: string[]. Paare aus Feld und Aggregation (z. B. all_rating/stats, storefronts/terms). Aggregationen: stats, terms, histogram, date_histogram, cardinality. Die vollständige Feldliste ist in docs get catalog_playbook dokumentiert.

• --query array, Standard []. Explorer-Abfrage im JSON-Array-Format, um passende Katalogprodukte auszuwählen. Fehlende Werte und [] entsprechen jedem Produkt in jeder Storefront. Die vollständige Feldliste und die Abfragesyntax sind in docs get catalog_playbook dokumentiert.

• --allow-unscoped-nested boolean, Standard false. Notausstieg für bewusst breite Abfragen. Umgeht die Standardblockierung von unbegrenzten verschachtelten Prädikaten, die Ergebnisse normalerweise aufblähen.

• --terms-count integer, Standard 20. Maximale Anzahl von Buckets, die für jede terms-Aggregation zurückgegeben werden. Andere Aggregationstypen ignorieren diesen Parameter.

• --date-histogram-interval string. Bucket-Granularität für jede date_histogram-Aggregation. Andere Aggregationstypen ignorieren diesen Parameter.

Beispiele

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

Listet die Katalogfelder und die Zugriffsebene des aktuellen Benutzers für jedes Feld auf. Durchsuchen Sie nach Stichwort, um Felder zu finden. Dieselbe Feldmenge, die explorer list-products und explorer aggregate-products akzeptieren.

Optionen

• --count integer, Standard 50. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, Standard 1. Seitennummer.

• --q string. Filtert nach path, title, description, type.

Beispiele

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

Fragt einen beliebigen numerischen Datensatz für eine oder mehrere Apps ab. Optional nach bis zu zwei Dimensionen gruppiert, zurückgegeben als verschachtelter Partitionsbaum, nicht als App-Datensätze. Unabhängig filterbar nach Land, Gerätetyp und Datumsbereich. Optionen vom Typ filterAppsBy* grenzen die App-Menge ein (nach ID, Storefront, Quelle oder Typ); ohne eine solche Option deckt eine Abfrage jede App ab, die das Konto überwacht.

Optionen

• <dataset> erforderlich: string. Der abzufragende Datensatz (z. B. sales.combined_downloads). Siehe metrics describe-datasets für die vollständige Liste und dafür, welche Datensätze private Daten sind (nur für Apps sichtbar, die Sie besitzen oder die geteilt wurden).

• --group-by string[]. Dimensionen, nach denen gruppiert werden soll. Maximal 2: Der erste Platz wird zum äußeren Entitätstyp, der zweite zur inneren Serie. Jede Dimension multipliziert die Ergebnisgröße.

• --granularity string. Zeitliche Granularität bei Gruppierung nach Datum.

• --count integer. Zeilengrenze. Mit --group-by die obersten N des äußeren Entitätstyps nach Wert (die frühesten N bei Gruppierung nach Datum). Ohne --group-by eine einseitige Vorschau.

• --countries string[]. Filtert auf einen oder mehrere ISO-Ländercodes (z. B. US, JP, GB).

• --device-type string. Gerätetyp.

• --all-time boolean, Standard false. Aktiviert die gesamte Historie. Ohne dieses Flag (und ohne start/end) fragt die Abfrage standardmäßig die letzten 30 Tage ab. Schließt sich mit start und end gegenseitig aus.

• --filter-apps-by-id (integer oder string)[]. Nur Daten zu bestimmten Apps einbeziehen, anhand der Produkt-ID oder der einheitlichen App-ID. Hat Vorrang vor den anderen filterAppsBy*-Schlüsseln, wenn es gesetzt ist. Storefront-, Quell- oder Typfilter sind besser für App-Sets geeignet, die über diese Kriterien beschrieben werden können.

• --filter-apps-by-storefront string[]. Schränkt die überwachten Apps des Kontos auf diejenigen in diesen Storefronts ein (z. B. apple:ios, google_play).

• --filter-apps-by-source string[]. Schränkt die überwachten Apps des Kontos anhand der Tracking-Beziehung ein.

• --filter-apps-by-type string[]. Schränkt die überwachten Apps des Kontos auf Produkte dieser Typen ein.

• --start string. Startdatum (YYYY-MM-DD).

• --end string. Enddatum (YYYY-MM-DD, Standard: heute).

Beispiele

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

Listet jeden numerischen Datensatz auf, den metrics query akzeptiert, eine Zeile pro Datensatz mit seinem Werttyp und ob er auf Ihre eigenen Apps beschränkt ist.

Optionen

• --count integer, Standard 50. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, Standard 1. Seitennummer.

• --q string. Filtert nach dataset, value_type, label, description.

Beispiele

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

Verfolgt den Ranking-Verlauf für eine oder mehrere Apps über Länder, Gerätetypen, Kategorie-Untertypen und Kategorien hinweg, als Zeitreihenpositionen mit Deltas zum Vortag.

Optionen

• <app-ids> erforderlich: (integer oder string)[]. App-Identifikatoren (einheitliche App-IDs oder Produkt-IDs).

• --countries string[]. Ländercodes für die Abfrage. Standardmäßig jedes Land mit Ranking-Abdeckung.

• --granularity string, Standard hourly. Abtastrate. Stündlich liefert die aktuellsten Daten; verwenden Sie --granularity=daily für eine kompakte mehrtägige Historie.

• --device-types string[], Standard ["handheld"]. Welche Gerätetypen einbezogen werden sollen; jeder wird in einem eigenen Diagramm geführt. Fügen Sie weitere hinzu, um die Antwort zu erweitern.

• --subtypes string[], Standard ["free"]. Welche Kategorie-Untertypen einbezogen werden sollen; jeder wird in einem eigenen Diagramm geführt. Fügen Sie weitere hinzu, um die Antwort zu erweitern.

• --category-ids integer[]. Filtert Antwortzeilen auf bestimmte Kategorie-IDs; für alle weglassen. Kategorie-IDs stammen aus store categories.

• --start string. Startdatum (YYYY-MM-DD).

• --end string. Enddatum (YYYY-MM-DD, Standard: heute).

• --count integer, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, Standard 1. Seitennummer.

Beispiele

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

Listet die Top-Apps in einem Kategorie-Diagramm für ein bestimmtes Land und eine bestimmte Kategorie mit aktuellen Positionen und Deltas zum Vortag.

Optionen

• --country erforderlich: string. ISO-Ländercode (z. B. US, JP, GB).

• --category-id erforderlich: integer. Kategorie-IDs stammen aus store categories.

• --subtype string, Standard free. Kategorie-Untertyp (Diagrammvariante innerhalb der Kategorie).

• --date string. Snapshot-Datum (YYYY-MM-DD, Standard: aktuell).

• --count integer, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, Standard 1. Seitennummer.

Beispiele

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

Listet jede Store-Kategorie mit ihrer ID auf. Die numerischen Kategorie-IDs, die von store app-ranks --category-ids und store top-charts --category-id benötigt werden, sind hier verfügbar.

Optionen

• --count integer, Standard 50. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, Standard 1. Seitennummer.

• --q string. Filtert nach name.

• --sort string. Feld, nach dem sortiert werden soll. Weglassen, um bei gesetztem q nach Relevanz zu sortieren, andernfalls in Listreihenfolge.

• --order string, Standard desc. Sortierrichtung.

• --category-id integer[]. Nur diese Kategorie-IDs zurückgeben.

• --parent-id integer. Nur Unterkategorien dieser übergeordneten Kategorie einbeziehen (Drill-down anhand der ID).

• --storefront string[]. Nur Kategorien von diesen Storefronts einbeziehen (z. B. apple:ios, google_play).

• --device-type string[]. Nur Kategorien für diese Gerätetypen einbeziehen (z. B. handheld, tablet).

• --all boolean, Standard false. Nicht-Ranking-Stores einbeziehen (roku, vizio usw.). Diese haben Kategorien, aber keine Ranking-Daten.

Beispiele

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

Listet vorgestellte und redaktionelle Platzierungen für eine App oder ein Storefront-Produkt auf. Fordern Sie 0 Zeilen an, um nur Zusammenfassungsstatistiken zu erhalten.

Optionen

• <app-id> erforderlich: integer oder string. Die einheitliche App-ID oder Produkt-ID der App.

• --countries string[]. Länder, die einbezogen werden sollen. Weglassen, um nur die USA abzufragen, oder mehrere angeben, um Märkte zu vergleichen. Um jedes Land einzubeziehen, setzen Sie stattdessen --all-countries.

• --all-countries boolean, Standard false. Jedes Land einbeziehen. Kann nicht mit --countries kombiniert werden.

• --include-rank-trend boolean, Standard false. Schließt rank_trend pro Intervall für jede Platzierung ein.

• --sort string, Standard relevance. Sortiert Platzierungen nach Relevanz oder Datum.

• --order string, Standard desc. Sortierrichtung.

• --start string. Startdatum (YYYY-MM-DD).

• --end string. Enddatum (YYYY-MM-DD, Standard: heute). Umfasst höchstens 31 Tage.

• --count integer, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, Standard 1. Seitennummer.

Beispiele

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

Liest den vollständigen Store-Eintrag für eine Storefront: lokalisierten Text (Name, Untertitel, Beschreibung, Versionshinweise) sowie Screenshots, Video, Kategorien, Monetarisierung, unterstützte Geräte, Länderverfügbarkeit, Preis, Dateigröße und Altersfreigabe. Erwartet eine numerische Produkt-ID (eine Storefront nach der anderen; eine einheitliche App hat ein Produkt pro Storefront). Ein Locale pro Anfrage.

Optionen

• <product-id> erforderlich: integer. Numerische Produkt-ID für eine Storefront. Keine einheitliche App-ID. Memberwerte von product_id sind über apps get '<unified-app-id>' verfügbar.

• --language string. Locale (z. B. en, ja, zh-Hans) für Name, Untertitel, Beschreibung, Versionshinweise und Screenshots. Standard ist en; es wird auf das erste verfügbare Locale zurückgegriffen, wenn das angeforderte keine Metadaten hat. Die Antwort gibt die aufgelöste Sprache zurück.

• --device-type string, Standard handheld. Relevant für Apple-Apps. Wählen Sie handheld für iPhone-spezifische Metadaten, tablet für iPad, desktop für Mac usw.

Beispiele

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

Liest die Zielgruppen-Demografie einer App: die geschätzte Aufschlüsselung nach Alter und Geschlecht.

Optionen

• <app-id> erforderlich: integer oder string. Die einheitliche App-ID oder Produkt-ID der App.

Beispiele

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

Findet die Apps, die Nutzer einer App ebenfalls verwenden.

Optionen

• <app-id> erforderlich: integer oder string. Die einheitliche App-ID oder Produkt-ID der App.

• --count integer, Standard 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, Standard 1. Seitennummer.

Beispiele

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

Liest einzelne Rezensionen für eine oder mehrere Apps. Gibt Rezensionstext, Sternebewertung, Land und App-Version zurück. Filterbar nach Sternebewertung, Datumsbereich, Land, Version und Tracking-Beziehung.

Optionen

• --stars number[]. Nach Sternebewertung filtern.

• --versions string[]. Nach App-Version filtern. Mehrere angeben, um sie zu kombinieren.

• --countries string[]. Auf einen oder mehrere ISO-Ländercodes filtern (z. B. US, JP, GB).

• --q string. Durchsucht Titel und Text von Bewertungen. Mehrere Schlüsselwörter angeben, um eines davon zu treffen. Groß-/Kleinschreibung wird ignoriert; kombiniert mit anderen Filtern.

• --sort string. Nach Bewertungsdatum oder Sternebewertung sortieren.

• --order string, default desc. Sortierrichtung.

• --filter-apps-by-id (integer or string)[]. Nur Daten zu bestimmten Apps einschließen, nach Produkt-ID oder vereinheitlichter App-ID. Hat Vorrang vor den anderen filterAppsBy*-Schlüsseln, wenn gesetzt. Storefront-, Quellen- oder Typfilter sind besser für App-Sets geeignet, die sich durch diese Kriterien beschreiben lassen.

• --filter-apps-by-storefront string[]. Die getrackten Apps des Kontos auf diejenigen in diesen Storefronts eingrenzen (z. B. apple:ios, google_play).

• --filter-apps-by-source string[]. Die getrackten Apps des Kontos nach Tracking-Beziehung eingrenzen.

• --filter-apps-by-type string[]. Die getrackten Apps des Kontos auf Produkte dieser Typen eingrenzen.

• --start string. Startdatum (YYYY-MM-DD)

• --end string. Enddatum (YYYY-MM-DD, Standard: heute)

• --count integer, default 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, default 1. Seitennummer. 1-500.

Beispiele

# 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

af reviews breakdown

af reviews breakdown [flags]

Aggregiert Bewertungsanzahlen für eine oder mehrere Apps, gruppiert nach Dimension. Gibt einen Zähler pro Dimensionswert zurück, plus eine Gesamtsumme über die übereinstimmende Menge.

Optionen

• --stars number[]. Nach Sternebewertung filtern.

• --versions string[]. Nach App-Version filtern. Mehrere angeben, um sie zu kombinieren.

• --countries string[]. Auf einen oder mehrere ISO-Ländercodes filtern (z. B. US, JP, GB).

• --q string. Durchsucht Titel und Text von Bewertungen. Mehrere Schlüsselwörter angeben, um eines davon zu treffen. Groß-/Kleinschreibung wird ignoriert; kombiniert mit anderen Filtern.

• --filter-apps-by-id (integer or string)[]. Nur Daten zu bestimmten Apps einschließen, nach Produkt-ID oder vereinheitlichter App-ID. Hat Vorrang vor den anderen filterAppsBy*-Schlüsseln, wenn gesetzt. Storefront-, Quellen- oder Typfilter sind besser für App-Sets geeignet, die sich durch diese Kriterien beschreiben lassen.

• --filter-apps-by-storefront string[]. Die getrackten Apps des Kontos auf diejenigen in diesen Storefronts eingrenzen (z. B. apple:ios, google_play).

• --filter-apps-by-source string[]. Die getrackten Apps des Kontos nach Tracking-Beziehung eingrenzen.

• --filter-apps-by-type string[]. Die getrackten Apps des Kontos auf Produkte dieser Typen eingrenzen.

• --start string. Startdatum (YYYY-MM-DD)

• --end string. Enddatum (YYYY-MM-DD, Standard: heute)

• --by string[]. Beschränkt die Antwort auf diese Dimensionen; weglassen, um alle zurückzugeben.

• --top integer, default 20. Maximale Anzahl an Werten pro Dimension; der Rest wird unter __other__ summiert.

Beispiele

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

Veröffentlicht oder zieht eine Entwicklerantwort auf eine bestimmte Bewertung zurück. content angeben, um zu veröffentlichen; delete: true angeben, um eine zuvor veröffentlichte Antwort zurückzuziehen. Gibt den resultierenden Status (published/pending bei einer Veröffentlichung, removed/removal_pending bei einem Rückzug) zusammen mit dem einreichenden Konto zurück.

Optionen

• <review-id> required string. Bewertung, auf die reagiert werden soll. review_id aus reviews list verwenden.

• --content string. Antworttext, den der Entwickler veröffentlichen möchte.

• --delete boolean. Zieht die zuvor veröffentlichte Antwort zu dieser Bewertung zurück. Schließt sich mit content gegenseitig aus.

Beispiele

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

Prüft die organischen Keywords, für die eine oder mehrere Apps ranken, mit Position, Beliebtheit und Wettbewerbsfähigkeit.

Optionen

• --product-ids integer[]. Produktkennungen (numerisch, jeweils eine Storefront).

• --countries required string[]. Ein oder mehrere ISO-Ländercodes (z. B. US, JP, GB). Mehrere angeben, um Märkte zu vergleichen.

• --device-type string. Gerätetyp

• --count integer, default 10. Anzahl der zurückzugebenden Ergebnisse (mindestens 10).

• --page integer, default 1. Seitennummer.

Beispiele

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

Listet die bezahlten Keywords, auf denen eine oder mehrere Apps Anzeigen schalten, mit Impression-Share und organischem Ranking.

Optionen

• <product-ids> required integer[]. Produktkennungen (numerisch, jeweils eine Storefront).

• --days integer, default 180. Rückblickzeitraum in Tagen. Übliche Werte: 7, 14, 30, 90, 180, 365.

• --countries required string[]. Ein oder mehrere ISO-Ländercodes (z. B. US, JP, GB). Mehrere angeben, um Märkte zu vergleichen.

• --device-types string[]. Nach Gerätetyp filtern. Standard: handheld.

• --count integer, default 10. Anzahl der zurückzugebenden Ergebnisse (mindestens 10).

• --page integer, default 1. Seitennummer.

Beispiele

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

Zeigt, wo alle deine getrackten Keywords für eine einzelne App-Land-Kombination ranken, mit der aktuellen Position jedes Keywords, der Veränderung seit der letzten Änderung, der Ausgangsposition, Beliebtheit und Wettbewerbsfähigkeit.

Optionen

• <product-id> required integer. Numerische Produkt-ID für eine Storefront. Keine vereinheitlichte App-ID. product_id-Werte von Mitgliedern sind über apps get '<unified-app-id>' verfügbar.

• --country required string. ISO-Ländercode (z. B. US, JP, GB)

• --device-type string. Gerät, für das Rankings gelesen werden sollen. Weglassen, um den Store-Standard zu verwenden.

• --count integer, default 10. Anzahl der zurückzugebenden Ergebnisse (mindestens 10).

• --page integer, default 1. Seitennummer.

• --sort string. Feld, nach dem die Ergebnisse sortiert werden sollen.

• --order string, default desc. Sortierrichtung.

• --start string. Beginn des Zeitfensters (YYYY-MM-DD). Bereich weglassen für die letzten 7 Tage; das Ranking am Startdatum ist die Ausgangspositions-Baseline.

• --end string. Ende des Zeitfensters (YYYY-MM-DD, Standard: heute). Umfasst höchstens 31 Tage.

• --keyword-term string. Nur getrackte Keywords einschließen, deren Begriff diesen Text enthält.

• --min-position integer. Beste einzubeziehende Position (1 = Spitze).

• --max-position integer. Schlechteste einzubeziehende Position.

• --min-popularity integer. Niedrigste einzubeziehende Beliebtheit (0-100).

• --max-popularity integer. Höchste einzubeziehende Beliebtheit (0-100).

• --min-competitiveness integer. Niedrigste einzubeziehende Wettbewerbsfähigkeit (0-100).

• --max-competitiveness integer. Höchste einzubeziehende Wettbewerbsfähigkeit (0-100).

Beispiele

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

Verfolgt, wie sich das Ranking eines getrackten Keywords im Laufe der Zeit für eine einzelne App-Land-Kombination ändert. Jeder Punkt zeigt das Ranking und um wie viele Positionen es sich seit dem vorherigen verschoben hat.

Optionen

• <keyword-id> required string. Das zu verfolgende Keyword. Muss für diese App und dieses Land getrackt sein; seine opake ID stammt aus keywords tracked-ranks oder keywords tracked.

• --product-id required integer. Numerische Produkt-ID für eine Storefront. Keine vereinheitlichte App-ID. product_id-Werte von Mitgliedern sind über apps get '<unified-app-id>' verfügbar.

• --country required string. ISO-Ländercode (z. B. US, JP, GB)

• --device-type string. Gerät, für das Rankings gelesen werden sollen. Weglassen, um den Store-Standard zu verwenden.

• --granularity string, default daily. Abtastrate.

• --start string. Beginn des Zeitfensters (YYYY-MM-DD). Bereich weglassen für die letzten 7 Tage.

• --end string. Ende des Zeitfensters (YYYY-MM-DD, Standard: heute). Umfasst höchstens 14 Tage bei stündlicher Granularität, 31 bei täglicher.

Beispiele

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

Entdecke Keyword-Ideen, die du für eine einzelne App-Land-Kombination ins Auge fassen kannst, sortiert nach Relevanz für die App und inklusive einiger aus Apps, mit denen du konkurrierst. Jede wird mit Beliebtheit, Wettbewerbsfähigkeit und dem aktuellen Ranking der App angezeigt.

Optionen

• <product-id> required integer. Numerische Produkt-ID für eine Storefront. Keine vereinheitlichte App-ID. product_id-Werte von Mitgliedern sind über apps get '<unified-app-id>' verfügbar.

• --country required string. ISO-Ländercode (z. B. US, JP, GB)

• --device-type string. Gerät, für das Rankings gelesen werden sollen. Weglassen, um den Store-Standard zu verwenden.

• --count integer, default 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, default 1. Seitennummer.

Beispiele

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

Listet die Apps, die für ein bestimmtes Keyword in der organischen Suche ranken, plus die Beliebtheits- und Wettbewerbsfähigkeitswerte des Keywords selbst.

Optionen

• <keyword-term> required string. Das nachzuschlagende Keyword.

• --country required string. ISO-Ländercode (z. B. US, JP, GB)

• --storefront required string. App-Store-Plattform (z. B. apple:ios, google_play, amazon_appstore, steam, windows10, apple:mac, apple:tv, apple:imessage oder eine andere unterstützte Storefront).

• --device-type string. Gerätetyp

• --count integer, default 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, default 1. Seitennummer.

Beispiele

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

Listet die Apps, die auf ein bestimmtes Keyword werben, mit dem Impression-Share jedes Werbetreibenden, dem organischen Ranking und wie lange sie bereits bieten.

Optionen

• <keyword-term> required string. Keyword, für das Werbetreibende nachgeschlagen werden sollen

• --days integer, default 180. Rückblickzeitraum in Tagen. Übliche Werte: 7, 14, 30, 90, 180, 365.

• --country required string. ISO-Ländercode (z. B. US, JP, GB)

• --device-type string. Gerätetyp

• --count integer, default 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, default 1. Seitennummer.

Beispiele

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

Findet zu einem Ausgangsbegriff verwandte Keywords für die ASO-Recherche. Nützlich, um Alternativen mit einem ähnlichen Publikum zu finden, die beliebter oder weniger wettbewerbsintensiv sind.

Optionen

• <keyword-term> required string. Ausgangs-Keyword, für das verwandte Begriffe gefunden werden sollen.

• --country required string. ISO-Ländercode (z. B. US, JP, GB)

• --storefront required string. App-Store-Plattform (z. B. apple:ios, google_play, amazon_appstore, steam, windows10, apple:mac, apple:tv, apple:imessage oder eine andere unterstützte Storefront).

• --device-type string. Gerätetyp

• --count integer, default 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, default 1. Seitennummer.

Beispiele

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

Listet getrackte Keywords mit ihren opaken IDs auf.

Optionen

• --count integer, default 10. Anzahl der zurückzugebenden Ergebnisse.

• --page integer, default 1. Seitennummer.

• --q string. Nach keyword_term filtern.

• --sort string. Feld, nach dem sortiert werden soll. Weglassen, um bei gesetztem q nach Relevanz zu sortieren, andernfalls in Listensortierung.

• --order string, default desc. Sortierrichtung.

• --include-relationships boolean, default false. Tracking-Details pro (Produkt, Land) und Synchronisierungsstatus in jeder Zeile einschließen. Standardmäßig aus; fügt einen verschachtelten Block pro getracktem (Produkt, Land)-Paar hinzu.

Beispiele

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

Verfolge ein Keyword, um den stündlichen Rang deiner App dafür im Zeitverlauf zu beobachten und automatische Benachrichtigungen zu erhalten, wenn sich seine Position ändert.

Optionen

• <keyword-term> erforderlicher String. Das Keyword, dessen Verfolgung gestartet werden soll.

• --product-id erforderliche Ganzzahl. Produkt-ID der App, für die das Keyword verfolgt werden soll.

• --country erforderlicher String. ISO-Ländercode (z. B. US, JP, GB)

Beispiele

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

Beende die Verfolgung eines Keywords.

Optionen

• <keyword-id> erforderlicher String. Kennung einer Zeile mit verfolgten Keywords (zurückgegeben von keywords tracked). Nicht der Keyword-Text.

Beispiele

# Stop tracking a keyword.
af keywords untrack a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

af apple-ads organizations

af apple-ads organizations [flags]

Liste die Apple Ads-Organisationen auf, in denen du Kampagnen verwaltest, jeweils mit Währung und Zeitzone.

Optionen

• --count Ganzzahl, Standard: 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard: 1. Seitennummer.

Beispiele

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

af apple-ads campaigns

af apple-ads campaigns [flags]

Liste deine Apple Ads-Kampagnen auf, jeweils mit Status, Budget, Zielländern und Zeitplan.

Optionen

• --display-status String. Filtert auf Kampagnen mit einem bestimmten Status. Weglassen, um alle Status einzuschließen.

• --name String. Filtert auf Kampagnen, deren Name diesen Text enthält.

• --countries string[]. Filtert auf Kampagnen, die auf mindestens eines dieser Länder ausgerichtet sind.

• --count Ganzzahl, Standard: 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard: 1. Seitennummer.

Beispiele

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

Liste Apple Ads-Anzeigengruppen auf, jeweils mit Standardgebot, CPA-Obergrenze, Preismodell und Zeitplan.

Optionen

• [campaign-id] String. Beschränkt die Anzeigengruppen auf eine einzelne Kampagne.

• --display-status String. Filtert auf Anzeigengruppen mit einem bestimmten Status. Weglassen, um alle Status einzuschließen.

• --name String. Filtert auf Anzeigengruppen, deren Name diese Teilzeichenfolge enthält.

• --count Ganzzahl, Standard: 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard: 1. Seitennummer.

Beispiele

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

Liste die Gebots-Keywords einer Kampagne auf, jeweils mit der Performance (Impressionen, Taps, Installationen, Ausgaben, Cost-per-Install) über einen Zeitraum sowie Match-Typ, Gebot und ob es sich um einen Targeting- oder Negativbegriff handelt.

Optionen

• <campaign-id> erforderlicher String. Kampagne, deren Gebots-Keywords aufgelistet werden sollen.

• --ad-group-id String. Filtert auf Keywords in einer Anzeigengruppe.

• --status String. Filtert auf Keywords mit einem bestimmten Status. Weglassen, um alle Status einzuschließen.

• --match-type String. Filtert auf einen einzelnen Match-Typ. Weglassen, um beide einzuschließen.

• --name String. Filtert auf Keywords, deren Text diese Teilzeichenfolge enthält.

• --sort String. Sortiert Keywords nach einer Performance-Kennzahl oder dem Gebot. Weglassen für neueste zuerst.

• --order String, Standard: desc. Sortierrichtung.

• --start String. Startdatum (YYYY-MM-DD)

• --end String. Enddatum (YYYY-MM-DD, Standard: heute)

• --count Ganzzahl, Standard: 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard: 1. Seitennummer.

Beispiele

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

Liste die tatsächlichen Nutzer-Suchbegriffe auf, die die Anzeigen einer Kampagne ausgelöst haben, jeweils mit ihrer Gesamtperformance (Impressionen, Taps, Installationen, Ausgaben, Cost-per-Install). Nutze diese, um neue Keywords zu entdecken, auf die du bieten oder die du ausschließen kannst.

Optionen

• <campaign-id> erforderlicher String. Kampagne, deren Suchbegriffe aufgelistet werden sollen.

• --count Ganzzahl, Standard: 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard: 1. Seitennummer.

Beispiele

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

Berichte über die Apple Ads-Performance pro Kampagne (Impressionen, Taps, Installationen, Ausgaben, Cost-per-Install) sowie eine kontoweite Gesamtsumme über einen Zeitraum.

Optionen

• --campaign-ids string[]. Beschränke den Bericht auf bestimmte Kampagnen.

• --start String. Startdatum (YYYY-MM-DD)

• --end String. Enddatum (YYYY-MM-DD, Standard: heute)

• --count Ganzzahl, Standard: 10. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard: 1. Seitennummer.

Beispiele

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

Zeige die leistungsstärksten Keywords einer Kampagne sortiert nach Conversion-Rate, Ausgaben und Installationen über einen Zeitraum. Jede Liste enthält die Top-Keywords für eine Kennzahl.

Optionen

• <campaign-id> erforderlicher String. Kampagne, deren Keywords gerankt werden sollen.

• --top Ganzzahl, Standard: 5. Wie viele Keywords pro Ranking zurückgegeben werden sollen (maximal 10).

• --start String. Startdatum (YYYY-MM-DD)

• --end String. Enddatum (YYYY-MM-DD, Standard: heute)

Beispiele

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

Liste jedes bekannte SDK mit seiner ID auf oder suche, um ein bestimmtes zu finden.

Optionen

• --count Ganzzahl, Standard: 50. Anzahl der zurückzugebenden Ergebnisse.

• --page Ganzzahl, Standard: 1. Seitennummer.

• --q String. Filtert nach name, description, tags.

• --sort String. Feld, nach dem sortiert werden soll. Weglassen, um nach Relevanz zu sortieren, wenn q gesetzt ist, andernfalls in Listenreihenfolge.

• --order String, Standard: desc. Sortierrichtung.

• --sdk-id string[]. Nur diese SDK-IDs zurückgeben.

• --include-inactive boolescher Wert, Standard: false. Inaktive SDKs einbeziehen. Selten; die meisten Aufrufer möchten nur aktive.

Beispiele

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

Gib ein Referenzdokument oder einen Leitfaden anhand des Slugs zurück.

Optionen

• <slug> erforderlicher String. Welches Referenzdokument zurückgegeben werden soll.

Beispiele

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

Sende eine rohe API-Anfrage für Endpunkte ohne eigenen Befehl. Endpunkte, Parameter und Antwortstrukturen sind unter https://docs.appfigures.com dokumentiert.

Optionen

• <path> erforderlicher String. API-Pfad (z. B. /users, /products)

• --method String, Standard: GET. HTTP-Methode (eine von: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)

• --body String. Anfragetext (JSON-String)

af mcp

af mcp

Starte einen MCP-Server über stdio, damit MCP-Clients wie Claude Desktop und Cursor Appfigures-Tools aufrufen können.

af auth login

af auth login [flags]

Melde dich bei Appfigures an.

Gibt eine URL aus, um diese CLI zu autorisieren. Öffne sie, genehmige den Zugriff und führe den Befehl dann mit --code <code> erneut aus, wobei du den Code verwendest, der nach der Genehmigung angezeigt wird. Verwende --interactive, um dich stattdessen über einen geführten Browserablauf anzumelden.

Für unbeaufsichtigte Nutzung (CI, Skripte) setze stattdessen die Umgebungsvariable APPFIGURES_API_KEY. Kein Browserablauf erforderlich.

Optionen

• --code String. Autorisierungscode von der OAuth-Zustimmungsseite. Zweiter Schritt von af auth login: Tauscht den Code aus, speichert das Token und beendet sich.

• --interactive boolescher Wert. Melde dich über einen geführten Browserablauf an.

af auth logout

af auth logout

Entferne gespeicherte Anmeldedaten.

af auth status

af auth status

Zeige den Authentifizierungs- und Kontostatus an.

Support

• Issues: github.com/appfigures/cli/issues

• API-Dokumentation: docs.appfigures.com

Mitwirken

Dieses Paket wird in einem privaten Monorepo entwickelt und hier als Spiegel veröffentlicht. Um Fehler zu melden oder Funktionen zu wünschen, eröffne ein Issue.

Wir stellen außerdem AI-native Entwickler ein. Wenn du die Zukunft der AI App Intelligence mitgestalten möchtest, bewirb dich unter appfigures.com/careers.

Lizenz

Apache 2.0