@appfigures/cli

La CLI de Appfigures: consulta métricas de apps, reseñas y datos de tiendas desde tu terminal.

Pruébala ahora sin instalar:

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

Instalación

npm install -g @appfigures/cli

Requiere Node.js 22+. También funciona con pnpm y yarn.

Related MCP server: asc-mcp

Inicio rápido

appfigures auth login
appfigures --help

También disponible como alias af.

Autenticación

• Inicia sesión tú mismo. af auth login --interactive abre un flujo guiado en tu navegador; aprueba y pega el código de vuelta.

• O deja que tu agente lo haga por ti. Por defecto, af auth login imprime una URL de autorización: ábrela, aprueba y termina con af auth login --code <code> usando el código mostrado. Un agente puede manejar esto de principio a fin. Para uso sin supervisión, configura APPFIGURES_API_KEY en su lugar: crea un token en appfigures.com/developers/keys haciendo clic en Create a New Client y luego en Create Personal Access Token.

Cualquiera de los dos métodos guarda el token en el administrador de credenciales de tu sistema operativo (macOS Keychain, Windows Credential Manager, Linux Secret Service). Consulta Entorno para APPFIGURES_API_KEY y otras anulaciones.

Servidor MCP

af mcp ejecuta un servidor local de Model Context Protocol sobre stdio, exponiendo los comandos de inteligencia de apps de la CLI como herramientas MCP. Apunta cualquier cliente MCP (Claude Code, Claude Desktop, Cursor, y otros) a él para que un agente pueda consultar métricas de apps, reseñas y datos de tiendas directamente.

Añádelo a la configuración MCP de tu cliente:

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

El servidor inicia sesión con tus credenciales guardadas, así que ejecuta af auth login una vez primero. Para una configuración sin supervisión, pasa un token a través del env del cliente en su lugar:

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

¿Instalaste la CLI globalmente en lugar de usar npx? Usa "command": "af" con "args": ["mcp"].

Claude Code. Añádelo con un solo comando:

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

Ejecuta af auth login primero para iniciar sesión, o añade --env APPFIGURES_API_KEY=<tu-token> para una configuración sin supervisión.

Comandos

Apps

Encuentra apps y consulta su identidad. Otros comandos usan los IDs de apps que estos devuelven.

Explorador

Busca y analiza el catálogo completo de apps: millones de productos en Apple, Google Play, Amazon y otras tiendas principales, con más de 120 campos que abarcan identidad, disponibilidad por tienda y país, categorías, calificaciones, fechas de lanzamiento, posiciones en rankings, estimaciones de descargas e ingresos, presencia de SDK, demografía y apps relacionadas.

Métricas

Consulta conjuntos de datos numéricos a través de dimensiones.

Tienda

Presencia en tiendas de apps: contenido de listados, rankings de categorías, gráficos principales y ubicaciones destacadas.

Audiencia

Quiénes son los usuarios de una app y qué más utilizan. Incluye la edad y el género estimados, además de la superposición de audiencia con otras apps.

Reseñas

Busca, resume y responde a reseñas de apps de iOS y Google Play.

Palabras clave

Visibilidad de palabras clave, seguimiento de posiciones y descubrimiento en la búsqueda orgánica (App Store, Google Play) y en Apple Ads.

Apple Ads

Gestiona tus campañas de Apple Ads, grupos de anuncios, palabras clave y rendimiento.

Sdks

Consulta los SDK que seguimos.

Docs

Documentación de referencia y guías para acciones específicas y tareas habituales.

API

MCP

Auth

Ejecuta af <comando> --help para ver argumentos, indicadores y ejemplos.

Entorno

Referencia de la API

Todos los comandos con su lista completa de argumentos e indicadores. Para la vista general de una línea, consulta Comandos más arriba.

Indicadores globales. Todos los comandos aceptan:

• -v, --verbose — Registra las solicitudes HTTP en stderr. También se puede configurar con AF_VERBOSE=1.

• -V, --version — Muestra la versión de la CLI y sale.

• -h, --help — Muestra el uso del comando actual.

Formato de salida. Cada comando emite un único valor JSON en stdout; canalízalo a jq para filtrarlo. Los mensajes informativos, las sugerencias y los avisos de actualización van a stderr para que las canalizaciones se mantengan limpias.

af apps search

af apps search <q> [flags]

Busca aplicaciones por nombre o editor. Devuelve una fila por aplicación unificada. De forma predeterminada devuelve los listados de Apple y Google; pasa --all-stores para incluir otras tiendas. Para filtrar aplicaciones por valores estimados (p. ej., aplicaciones con más de 100 000 descargas el mes pasado) usa explorer list-products. Para estimaciones desglosadas por tiempo, país o tienda, usa metrics query con los conjuntos de datos estimates.sales o estimates.revenue.

Opciones

• <q> cadena obligatoria. Consulta de búsqueda (nombre de la aplicación o del editor).

• --all-stores booleano, predeterminado false. Incluye tiendas más allá de Apple y Google: Amazon, Windows, Steam, Roku, LG TV, Samsung TV y otras.

• --count entero, predeterminado 10. Número de resultados que devolver.

• --page entero, predeterminado 1. Número de página.

Ejemplos

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

Lista las aplicaciones que tu cuenta de Appfigures sigue.

Opciones

• --count entero, predeterminado 10. Número de resultados que devolver.

• --page entero, predeterminado 1. Número de página.

• --q cadena. Nombre de la aplicación por el que filtrar.

• --filter-apps-by-id (entero o cadena)[]. Incluye solo datos sobre aplicaciones específicas, por ID de producto o ID de aplicación unificada. Tiene prioridad sobre las demás claves filterAppsBy* cuando se establece. Los filtros por tienda, fuente o tipo son mejores para conjuntos de aplicaciones que se pueden describir con esos criterios.

• --filter-apps-by-storefront cadena[]. Reduce las aplicaciones seguidas de la cuenta a las que están en estas tiendas (p. ej., apple:ios, google_play).

• --filter-apps-by-source cadena[]. Reduce las aplicaciones seguidas de la cuenta por relación de seguimiento.

• --filter-apps-by-type cadena[]. Reduce las aplicaciones seguidas de la cuenta a productos de estos tipos.

Ejemplos

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

Obtiene el registro de una aplicación: metadatos básicos (nombre, desarrollador, etc.) y, si el usuario la sigue, a qué datos puede acceder. Pasa un ID de producto para una tienda; un ID de aplicación unificada para todas las tiendas juntas.

Opciones

• <app-id> entero o cadena obligatorio. El ID de aplicación unificada o el ID de producto de la aplicación.

• --all-stores booleano, predeterminado false. Para un ID de aplicación unificada: incluye los productos miembros de todas las tiendas (Amazon, Steam, Windows, Roku, etc.). Cuando es false, member_products se limita a las tiendas con cobertura de inteligencia de aplicaciones (iOS + Google Play). Se ignora para ID de producto.

Ejemplos

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

Lee los campos del catálogo de una aplicación o de muchas. Los campos a los que hace referencia query o sort se devuelven automáticamente; pasa --extra-fields para obtener más. Usa ["match","product_id",<id>] para una sola aplicación, o combina filtros para consultas de población (p. ej., aplicaciones iOS que usan Firebase con más de 1 millón de USD de ingresos en EE. UU.). Los más de 120 campos abarcan clasificaciones, valoraciones, estimaciones de descargas e ingresos, SDK, datos demográficos y más; la gramática de consulta y la lista de campos están en docs get catalog_playbook.

Opciones

• --query matriz, predeterminado []. Consulta de Explorer en formato de matriz JSON para seleccionar Productos del catálogo que coincidan. Los valores ausentes y [] coinciden con todos los Productos de todas las tiendas. La lista completa de campos y la sintaxis de consulta están documentadas en docs get catalog_playbook.

• --extra-fields cadena[]. Campos adicionales que incluir más allá de los que tu query o sort ya referencian. Encuentra las rutas de los campos (y cuáles puedes leer) con explorer describe-fields.

• --sort cadena. Nombre del campo de Explorer. La lista completa de campos está documentada en docs get catalog_playbook.

• --order cadena, predeterminado desc. Dirección de ordenación.

• --count entero, predeterminado 10. Número de resultados que devolver.

• --page entero, predeterminado 1. Número de página.

• --allow-unscoped-nested booleano, predeterminado false. Vía de escape para consultas deliberadamente amplias. Omite el bloqueo predeterminado de predicados anidados sin ámbito que normalmente inflan los resultados.

Ejemplos

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

Agrega todo el catálogo de millones de productos de Apple, Google Play, Amazon y otras tiendas importantes: recuentos, promedios, mínimos/máximos e histogramas sobre cualquier conjunto de productos que coincidan. Usa la misma gramática de consulta que explorer list-products; devuelve agregados, no registros de productos. Para dimensionar el mercado, hacer evaluaciones comparativas y análisis de segmentos.

Opciones

• <fields> obligatorio string[]. Pares de campo+agregación (p. ej. all_rating/stats, storefronts/terms). Agregaciones: stats, terms, histogram, date_histogram, cardinality. La lista completa de campos está documentada en docs get catalog_playbook.

• --query array, por defecto []. Consulta de Explorer en formato de matriz JSON para seleccionar Productos de catálogo coincidentes. Los valores faltantes y [] coinciden con todos los Productos en todas las tiendas. La lista completa de campos y la sintaxis de consulta están documentadas en docs get catalog_playbook.

• --allow-unscoped-nested booleano, por defecto false. Vía de escape para consultas intencionalmente amplias. Omite el bloqueo predeterminado en predicados anidados sin ámbito que suelen inflar los resultados.

• --terms-count entero, por defecto 20. Máximo de cubos devueltos para cada agregación terms. Los demás tipos de agregación lo ignoran.

• --date-histogram-interval cadena. Granularidad de cubos para cada agregación date_histogram. Los demás tipos de agregación lo ignoran.

Ejemplos

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

Lista los campos del catálogo y el nivel de acceso del usuario actual para cada uno. Busca por palabra clave para encontrar campos. El mismo conjunto de campos que aceptan explorer list-products y explorer aggregate-products.

Opciones

• --count entero, por defecto 50. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

• --q cadena. Filtra por path, title, description, type.

Ejemplos

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

Consulta cualquier conjunto de datos numérico para una o más aplicaciones. Opcionalmente agrupado por hasta dos dimensiones, devuelto como un árbol de particiones anidado, no como registros de aplicaciones. Filtrable de forma independiente por país, tipo de dispositivo y rango de fechas. Las opciones filterAppsBy* reducen el conjunto de aplicaciones (por ID, tienda, fuente o tipo); sin una, una consulta cubre todas las aplicaciones que la cuenta rastrea.

Opciones

• <dataset> obligatorio cadena. Conjunto de datos a consultar (p. ej. sales.combined_downloads). Consulta metrics describe-datasets para ver la lista completa y qué conjuntos de datos son datos privados (visibles solo para aplicaciones que posees o que se compartieron).

• --group-by cadena[]. Dimensiones para agrupar. Máximo 2: la primera ranura se convierte en el tipo de entidad externo, la segunda en la serie interna. Cada dimensión multiplica el tamaño del resultado.

• --granularity cadena. Granularidad temporal al agrupar por fecha

• --count entero. Límite de filas. Con --group-by, los N principales del tipo de entidad externo por valor (los N más antiguos al agrupar por fecha). Sin --group-by, vista previa de una sola página.

• --countries cadena[]. Filtra a uno o más códigos de país ISO (p. ej. US, JP, GB)

• --device-type cadena. Tipo de dispositivo

• --all-time booleano, por defecto false. Opta por todo el historial. Sin esta bandera (y sin start/end), la consulta se establece por defecto en los últimos 30 días. Mutuamente excluyente con start y end.

• --filter-apps-by-id (entero o cadena)[]. Solo incluye datos sobre aplicaciones específicas, por ID de producto o ID de aplicación unificada. Tiene prioridad sobre las otras claves filterAppsBy* cuando se establece. Los filtros de tienda, fuente o tipo son mejores para conjuntos de aplicaciones que se pueden describir con esos criterios.

• --filter-apps-by-storefront cadena[]. Reduce las aplicaciones rastreadas de la cuenta a las de estas tiendas (p. ej. apple:ios, google_play).

• --filter-apps-by-source cadena[]. Reduce las aplicaciones rastreadas de la cuenta por relación de seguimiento.

• --filter-apps-by-type cadena[]. Reduce las aplicaciones rastreadas de la cuenta a productos de estos tipos.

• --start cadena. Fecha de inicio (YYYY-MM-DD)

• --end cadena. Fecha de fin (YYYY-MM-DD, por defecto hoy)

Ejemplos

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

Lista todos los conjuntos de datos numéricos que acepta metrics query, una fila por conjunto de datos con su tipo de valor y si está limitado a tus propias aplicaciones.

Opciones

• --count entero, por defecto 50. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

• --q cadena. Filtra por dataset, value_type, label, description.

Ejemplos

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

Rastrea el historial de clasificación de una o más aplicaciones en países, tipos de dispositivo, subtipos de categoría y categorías, como posiciones de series temporales con deltas día a día.

Opciones

• <app-ids> obligatorio (entero o cadena)[]. Identificadores de aplicación (ID de aplicación unificada o ID de producto)

• --countries cadena[]. Códigos de país a consultar. Por defecto, todos los países con cobertura de clasificación.

• --granularity cadena, por defecto hourly. Tasa de muestreo. La opción por hora da los datos más recientes; usa --granularity=daily para un historial compacto de varios días.

• --device-types cadena[], por defecto ["handheld"]. Qué tipos de dispositivo incluir; cada uno se clasifica en su propio gráfico. Añade más para ampliar la respuesta.

• --subtypes cadena[], por defecto ["free"]. Qué subtipos de categoría incluir; cada uno se clasifica en su propio gráfico. Añade más para ampliar la respuesta.

• --category-ids entero[]. Filtra las filas de respuesta a ID de categoría específicos; omítelo para todos. Los ID de categoría provienen de store categories.

• --start cadena. Fecha de inicio (YYYY-MM-DD)

• --end cadena. Fecha de fin (YYYY-MM-DD, por defecto hoy)

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Lista las aplicaciones principales en un gráfico de categoría para un país y categoría determinados, con posiciones actuales y deltas día a día.

Opciones

• --country obligatorio cadena. Código de país ISO (p. ej. US, JP, GB)

• --category-id obligatorio entero. Los ID de categoría provienen de store categories.

• --subtype cadena, por defecto free. Subtipo de categoría (variante de gráfico dentro de la categoría).

• --date cadena. Fecha de instantánea (YYYY-MM-DD, por defecto la actual).

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Lista todas las categorías de tienda con su ID. Los ID de categoría numéricos requeridos por store app-ranks --category-ids y store top-charts --category-id están disponibles aquí.

Opciones

• --count entero, por defecto 50. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

• --q cadena. Filtra por name.

• --sort cadena. Campo por el que ordenar. Omítelo para ordenar por relevancia cuando q esté establecido; de lo contrario, orden de lista.

• --order cadena, por defecto desc. Dirección de ordenación.

• --category-id entero[]. Solo devuelve estos ID de categoría.

• --parent-id entero. Solo incluye subcategorías de esta categoría principal (profundización por id).

• --storefront cadena[]. Solo incluye categorías de estas tiendas (p. ej. apple:ios, google_play).

• --device-type cadena[]. Solo incluye categorías para estos tipos de dispositivo (p. ej. handheld, tablet).

• --all booleano, por defecto false. Incluye tiendas sin clasificación (roku, vizio, etc.). Estas tienen categorías pero no datos de clasificación.

Ejemplos

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

Lista las ubicaciones destacadas y editoriales para una aplicación o producto de tienda. Solicita 0 filas para solo estadísticas resumidas.

Opciones

• <app-id> obligatorio entero o cadena. El ID de aplicación unificada o ID de producto de la aplicación.

• --countries cadena[]. Países a incluir. Omítelo para consultar solo EE. UU., o pasa varios para comparar mercados. Para incluir todos los países, establece --all-countries en su lugar.

• --all-countries booleano, por defecto false. Incluye todos los países. No se puede combinar con --countries.

• --include-rank-trend booleano, por defecto false. Incluye rank_trend por intervalo para cada ubicación.

• --sort cadena, por defecto relevance. Ordena las ubicaciones por relevancia o fecha.

• --order cadena, por defecto desc. Dirección de ordenación.

• --start cadena. Fecha de inicio (YYYY-MM-DD)

• --end cadena. Fecha de fin (YYYY-MM-DD, por defecto hoy). Abarca como máximo 31 días.

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Lee la ficha completa de la tienda para una tienda: texto localizado (nombre, subtítulo, descripción, notas de la versión) más capturas de pantalla, video, categorías, monetización, dispositivos compatibles, disponibilidad por país, precio, tamaño del archivo y clasificación por edad. Toma un ID de producto numérico (una tienda a la vez; una aplicación unificada tiene un producto por tienda). Una configuración regional por solicitud.

Opciones

• <product-id> obligatorio entero. ID de producto numérico para una tienda. No es un ID de aplicación unificada. Los valores de product_id de los miembros están disponibles en apps get '<unified-app-id>'.

• --language cadena. Configuración regional (p. ej. en, ja, zh-Hans) para nombre, subtítulo, descripción, notas de la versión y capturas de pantalla. Por defecto en; recurre a la primera configuración regional disponible cuando la solicitada no tiene metadatos. La respuesta refleja el idioma resuelto.

• --device-type cadena, por defecto handheld. Relevante para aplicaciones de Apple. Elige handheld para metadatos específicos de iPhone, tablet para iPad, desktop para Mac, etc.

Ejemplos

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

Lee la demografía de la audiencia de una aplicación: la distribución estimada por edad y género.

Opciones

• <app-id> obligatorio entero o cadena. El ID de aplicación unificada o ID de producto de la aplicación.

Ejemplos

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

Encuentra las aplicaciones que también usan los usuarios de una aplicación.

Opciones

• <app-id> obligatorio entero o cadena. El ID de aplicación unificada o ID de producto de la aplicación.

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Lee reseñas individuales de una o más aplicaciones. Devuelve el texto de la reseña, la calificación de estrellas, el país y la versión de la aplicación. Filtrable por calificación de estrellas, rango de fechas, país, versión y relación de seguimiento.

Opciones

• --stars número[]. Filtrar por valoración de estrellas.

• --versions cadena[]. Filtrar por versión de la app. Pasa varias para combinarlas.

• --countries cadena[]. Filtrar por uno o más códigos de país ISO (p. ej., US, JP, GB).

• --q cadena. Buscar en el título y el cuerpo de la reseña. Pasa varias palabras clave para que coincida con cualquiera. No distingue mayúsculas de minúsculas; se combina con otros filtros.

• --sort cadena. Ordenar por fecha de la reseña o valoración de estrellas.

• --order cadena, por defecto desc. Dirección de ordenación.

• --filter-apps-by-id (entero o cadena)[]. Incluir solo datos sobre apps específicas, por ID de producto o ID de app unificado. Cuando se especifica, tiene prioridad sobre las demás claves filterAppsBy*. Los filtros por tienda, fuente o tipo son mejores para conjuntos de apps que puedan describirse con esos criterios.

• --filter-apps-by-storefront cadena[]. Reducir las apps rastreadas de la cuenta a las de estas tiendas (p. ej., apple:ios, google_play).

• --filter-apps-by-source cadena[]. Reducir las apps rastreadas de la cuenta según la relación de seguimiento.

• --filter-apps-by-type cadena[]. Reducir las apps rastreadas de la cuenta a productos de estos tipos.

• --start cadena. Fecha de inicio (YYYY-MM-DD)

• --end cadena. Fecha de fin (YYYY-MM-DD, por defecto hoy)

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página. 1-500.

Ejemplos

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

Agrega los recuentos de reseñas de una o más apps, agrupados por dimensión. Devuelve un recuento por valor de dimensión, además de un total global del conjunto coincidente.

Opciones

• --stars número[]. Filtrar por valoración de estrellas.

• --versions cadena[]. Filtrar por versión de la app. Pasa varias para combinarlas.

• --countries cadena[]. Filtrar por uno o más códigos de país ISO (p. ej., US, JP, GB).

• --q cadena. Buscar en el título y el cuerpo de la reseña. Pasa varias palabras clave para que coincida con cualquiera. No distingue mayúsculas de minúsculas; se combina con otros filtros.

• --filter-apps-by-id (entero o cadena)[]. Incluir solo datos sobre apps específicas, por ID de producto o ID de app unificado. Cuando se especifica, tiene prioridad sobre las demás claves filterAppsBy*. Los filtros por tienda, fuente o tipo son mejores para conjuntos de apps que puedan describirse con esos criterios.

• --filter-apps-by-storefront cadena[]. Reducir las apps rastreadas de la cuenta a las de estas tiendas (p. ej., apple:ios, google_play).

• --filter-apps-by-source cadena[]. Reducir las apps rastreadas de la cuenta según la relación de seguimiento.

• --filter-apps-by-type cadena[]. Reducir las apps rastreadas de la cuenta a productos de estos tipos.

• --start cadena. Fecha de inicio (YYYY-MM-DD)

• --end cadena. Fecha de fin (YYYY-MM-DD, por defecto hoy)

• --by cadena[]. Limitar la respuesta a estas dimensiones; omítelo para devolver todas.

• --top entero, por defecto 20. Máximo de valores devueltos por dimensión; el resto se suma en __other__.

Ejemplos

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

Publica o retira una respuesta de desarrollador en una reseña específica. Pasa content para publicar; pasa delete: true para retirar una respuesta publicada anteriormente. Devuelve el estado resultante (published/pending para una publicación, removed/removal_pending para una retirada) junto con la cuenta que la envía.

Opciones

• <review-id> cadena obligatoria. Reseña sobre la que actuar. Usa review_id de reviews list.

• --content cadena. Texto de la respuesta que el desarrollador quiere publicar.

• --delete booleano. Retira la respuesta publicada anteriormente en esta reseña. Es mutuamente excluyente con content.

Ejemplos

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

Consulta las palabras clave orgánicas para las que posiciona una o más apps, con posición, popularidad y competitividad.

Opciones

• --product-ids entero[]. Identificadores de producto (numéricos, una tienda cada uno).

• --countries cadena[] obligatoria. Uno o más códigos de país ISO (p. ej., US, JP, GB). Pasa varios para comparar mercados.

• --device-type cadena. Tipo de dispositivo

• --count entero, por defecto 10. Número de resultados a devolver (mín. 10).

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Enumera las palabras clave de pago en las que una o más apps publican anuncios, con cuota de impresiones y posición orgánica.

Opciones

• <product-ids> entero[] obligatorio. Identificadores de producto (numéricos, una tienda cada uno).

• --days entero, por defecto 180. Período de retrospectiva en días. Valores habituales: 7, 14, 30, 90, 180, 365.

• --countries cadena[] obligatoria. Uno o más códigos de país ISO (p. ej., US, JP, GB). Pasa varios para comparar mercados.

• --device-types cadena[]. Filtrar por tipo de dispositivo. Por defecto, handheld.

• --count entero, por defecto 10. Número de resultados a devolver (mín. 10).

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Consulta en qué posición se encuentran todas tus palabras clave rastreadas para una combinación de app y país, con la posición actual de cada palabra clave, el movimiento desde su último cambio, la posición inicial, la popularidad y la competitividad.

Opciones

• <product-id> entero obligatorio. ID de producto numérico para una tienda. No es un ID de app unificado. Los valores de product_id de los miembros están disponibles en apps get '<unified-app-id>'.

• --country cadena obligatoria. Código de país ISO (p. ej., US, JP, GB)

• --device-type cadena. Dispositivo del que leer las posiciones. Omítelo para usar el valor predeterminado de la tienda.

• --count entero, por defecto 10. Número de resultados a devolver (mín. 10).

• --page entero, por defecto 1. Número de página.

• --sort cadena. Campo por el que ordenar los resultados.

• --order cadena, por defecto desc. Dirección de ordenación.

• --start cadena. Inicio de la ventana (YYYY-MM-DD). Omite el rango para los últimos 7 días; la posición en la fecha de inicio es la línea base de la posición inicial.

• --end cadena. Fin de la ventana (YYYY-MM-DD, por defecto hoy). Abarca como máximo 31 días.

• --keyword-term cadena. Incluir solo las palabras clave rastreadas cuyo término contenga este texto.

• --min-position entero. Mejor posición a incluir (1 = la primera).

• --max-position entero. Peor posición a incluir.

• --min-popularity entero. Popularidad más baja a incluir (0-100).

• --max-popularity entero. Popularidad más alta a incluir (0-100).

• --min-competitiveness entero. Competitividad más baja a incluir (0-100).

• --max-competitiveness entero. Competitividad más alta a incluir (0-100).

Ejemplos

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

Rastrea cómo cambia a lo largo del tiempo la posición de una palabra clave rastreada para una sola combinación de app y país. Cada punto indica la posición y cuántas posiciones se ha movido desde el punto anterior.

Opciones

• <keyword-id> cadena obligatoria. La palabra clave a rastrear. Debe estar rastreada para esta app y país; su id opaco proviene de keywords tracked-ranks o keywords tracked.

• --product-id entero obligatorio. ID de producto numérico para una tienda. No es un ID de app unificado. Los valores de product_id de los miembros están disponibles en apps get '<unified-app-id>'.

• --country cadena obligatoria. Código de país ISO (p. ej., US, JP, GB)

• --device-type cadena. Dispositivo del que leer las posiciones. Omítelo para usar el valor predeterminado de la tienda.

• --granularity cadena, por defecto daily. Frecuencia de muestreo.

• --start cadena. Inicio de la ventana (YYYY-MM-DD). Omite el rango para los últimos 7 días.

• --end cadena. Fin de la ventana (YYYY-MM-DD, por defecto hoy). Abarca como máximo 14 días para la granularidad horaria y 31 para la diaria.

Ejemplos

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

Descubre ideas de palabras clave que considerar para una sola combinación de app y país, ordenadas por relevancia para la app e incluyendo algunas extraídas de las apps con las que compites. Cada una incluye su popularidad, competitividad y la posición actual de la app.

Opciones

• <product-id> entero obligatorio. ID de producto numérico para una tienda. No es un ID de app unificado. Los valores de product_id de los miembros están disponibles en apps get '<unified-app-id>'.

• --country cadena obligatoria. Código de país ISO (p. ej., US, JP, GB)

• --device-type cadena. Dispositivo del que leer las posiciones. Omítelo para usar el valor predeterminado de la tienda.

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Enumera las apps que posicionan para una palabra clave específica en la búsqueda orgánica, además de las puntuaciones de popularidad y competitividad de la propia palabra clave.

Opciones

• <keyword-term> cadena obligatoria. Palabra clave a consultar.

• --country cadena obligatoria. Código de país ISO (p. ej., US, JP, GB)

• --storefront cadena obligatoria. Plataforma de tienda de apps (p. ej., apple:ios, google_play, amazon_appstore, steam, windows10, apple:mac, apple:tv, apple:imessage, u otra tienda compatible).

• --device-type cadena. Tipo de dispositivo

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Enumera las apps que publican anuncios en una palabra clave específica, con la cuota de impresiones de cada anunciante, su posición orgánica y cuánto tiempo llevan pujando.

Opciones

• <keyword-term> cadena obligatoria. Palabra clave para la que consultar anunciantes

• --days entero, por defecto 180. Período de retrospectiva en días. Valores habituales: 7, 14, 30, 90, 180, 365.

• --country cadena obligatoria. Código de país ISO (p. ej., US, JP, GB)

• --device-type cadena. Tipo de dispositivo

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Encuentra palabras clave relacionadas con un término semilla para la investigación de ASO. Resulta útil para encontrar alternativas con una audiencia similar que sean más populares o menos competitivas.

Opciones

• <keyword-term> cadena obligatoria. Palabra clave semilla para encontrar términos relacionados.

• --country cadena obligatoria. Código de país ISO (p. ej., US, JP, GB)

• --storefront cadena obligatoria. Plataforma de tienda de apps (p. ej., apple:ios, google_play, amazon_appstore, steam, windows10, apple:mac, apple:tv, apple:imessage, u otra tienda compatible).

• --device-type cadena. Tipo de dispositivo

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Enumera las palabras clave rastreadas con sus IDs opacos.

Opciones

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

• --q cadena. Filtrar por keyword_term.

• --sort cadena. Campo por el que ordenar. Omítelo para ordenar por relevancia cuando q esté establecido; de lo contrario, por orden de lista.

• --order cadena, por defecto desc. Dirección de ordenación.

• --include-relationships booleano, por defecto false. Incluir el detalle de seguimiento por (producto, país) y el estado de sincronización en cada fila. Desactivado por defecto; añade un bloque anidado por cada par (producto, país) rastreado.

Ejemplos

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

Realiza un seguimiento de una palabra clave para supervisar la clasificación horaria de tu aplicación a lo largo del tiempo y recibe alertas automáticas cuando cambie su posición.

Opciones

• <keyword-term> cadena obligatoria. Palabra clave para comenzar a rastrear.

• --product-id entero obligatorio. ID del producto de la aplicación para la que se rastreará la palabra clave.

• --country cadena obligatoria. Código de país ISO (p. ej., US, JP, GB).

Ejemplos

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

Deja de rastrear una palabra clave.

Opciones

• <keyword-id> cadena obligatoria. Identificador de una fila de palabra clave rastreada (devuelto por keywords tracked). No es el texto de la palabra clave.

Ejemplos

# Stop tracking a keyword.
af keywords untrack a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

af apple-ads organizations

af apple-ads organizations [flags]

Enumera las organizaciones de Apple Ads en las que gestionas campañas, con la moneda y la zona horaria de cada una.

Opciones

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

af apple-ads campaigns

af apple-ads campaigns [flags]

Enumera tus campañas de Apple Ads con el estado, presupuesto, países objetivo y programación de cada una.

Opciones

• --display-status cadena. Filtra a campañas en un estado. Omítelo para incluir todos los estados.

• --name cadena. Filtra a campañas cuyo nombre contenga este texto.

• --countries cadena[]. Filtra a campañas que tengan como objetivo cualquiera de estos países.

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Enumera los grupos de anuncios de Apple Ads con la oferta predeterminada, el límite de CPA, el modelo de precios y la programación de cada uno.

Opciones

• [campaign-id] cadena. Limita a grupos de anuncios de una sola campaña.

• --display-status cadena. Filtra a grupos de anuncios en un estado. Omítelo para incluir todos los estados.

• --name cadena. Filtra a grupos de anuncios cuyo nombre contenga esta subcadena.

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Enumera las palabras clave de oferta de una campaña con el rendimiento de cada una (impresiones, toques, instalaciones, gasto, costo por instalación) durante un período de fechas, además de su tipo de coincidencia, oferta y si es un término de segmentación o negativo.

Opciones

• <campaign-id> cadena obligatoria. Campaña cuyas palabras clave de oferta se van a enumerar.

• --ad-group-id cadena. Filtra a palabras clave en un grupo de anuncios.

• --status cadena. Filtra a palabras clave en un estado. Omítelo para incluir todos los estados.

• --match-type cadena. Filtra a un tipo de coincidencia. Omítelo para incluir ambos.

• --name cadena. Filtra a palabras clave cuyo texto contenga esta subcadena.

• --sort cadena. Ordena las palabras clave por una métrica de rendimiento o por la oferta. Omítelo para las más recientes primero.

• --order cadena, por defecto desc. Dirección de ordenación.

• --start cadena. Fecha de inicio (AAAA-MM-DD)

• --end cadena. Fecha de fin (AAAA-MM-DD, por defecto hoy)

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Enumera los términos de búsqueda reales de los usuarios que activaron los anuncios de una campaña, cada uno con su rendimiento histórico (impresiones, toques, instalaciones, gasto, costo por instalación). Úsalos para descubrir nuevas palabras clave por las que pujar o para excluir.

Opciones

• <campaign-id> cadena obligatoria. Campaña cuyos términos de búsqueda se van a enumerar.

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Informa del rendimiento de Apple Ads por campaña (impresiones, toques, instalaciones, gasto, costo por instalación), además de un total general de la cuenta, durante un período de fechas.

Opciones

• --campaign-ids cadena[]. Limita el informe a campañas específicas.

• --start cadena. Fecha de inicio (AAAA-MM-DD)

• --end cadena. Fecha de fin (AAAA-MM-DD, por defecto hoy)

• --count entero, por defecto 10. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

Ejemplos

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

Clasifica las palabras clave de mejor rendimiento de una campaña por tasa de conversión, gasto e instalaciones durante un período de fechas. Cada lista contiene las palabras clave principales según una métrica.

Opciones

• <campaign-id> cadena obligatoria. Campaña para la que se clasificarán las palabras clave.

• --top entero, por defecto 5. Cuántas palabras clave devolver por clasificación (máx. 10).

• --start cadena. Fecha de inicio (AAAA-MM-DD)

• --end cadena. Fecha de fin (AAAA-MM-DD, por defecto hoy)

Ejemplos

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

Enumera todos los SDK conocidos con su id, o busca para encontrar uno específico.

Opciones

• --count entero, por defecto 50. Número de resultados a devolver.

• --page entero, por defecto 1. Número de página.

• --q cadena. Filtra por name, description, tags.

• --sort cadena. Campo por el que ordenar. Omítelo para ordenar por relevancia cuando q esté definido; de lo contrario, por orden de lista.

• --order cadena, por defecto desc. Dirección de ordenación.

• --sdk-id cadena[]. Devuelve solo estos ids de SDK.

• --include-inactive booleano, por defecto false. Incluye SDK inactivos. Poco común; la mayoría de los llamadores solo quieren activos.

Ejemplos

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

Devuelve un documento de referencia o una guía por slug.

Opciones

• <slug> cadena obligatoria. Qué referencia devolver

Ejemplos

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

Realiza una solicitud API sin procesar para endpoints sin un comando dedicado. Los endpoints, parámetros y formas de respuesta están documentados en https://docs.appfigures.com.

Opciones

• <path> cadena obligatoria. Ruta de la API (p. ej., /users, /products)

• --method cadena, por defecto GET. Método HTTP (uno de: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)

• --body cadena. Cuerpo de la solicitud (cadena JSON)

af mcp

af mcp

Ejecuta un servidor MCP sobre stdio para que clientes MCP como Claude Desktop y Cursor puedan llamar a las herramientas de Appfigures.

af auth login

af auth login [flags]

Inicia sesión en Appfigures

Imprime una URL para autorizar esta CLI. Ábrela, aprueba el acceso y luego vuelve a ejecutarla con --code <code> usando el código que se muestra después de la aprobación. Pasa --interactive para iniciar sesión mediante un flujo de navegador guiado en su lugar.

Para uso desatendido (CI, scripts), establece APPFIGURES_API_KEY en el entorno en su lugar. No se necesita flujo de navegador.

Opciones

• --code cadena. Código de autorización de la página de consentimiento de OAuth. Segundo paso de af auth login: intercambia el código, guarda el token y sale.

• --interactive booleano. Inicia sesión mediante un flujo de navegador guiado.

af auth logout

af auth logout

Elimina las credenciales almacenadas

af auth status

af auth status

Muestra el estado de autenticación y de la cuenta

Soporte

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

• Documentación de la API: docs.appfigures.com

Contribuciones

Este paquete se desarrolla en un monorepo privado y se publica aquí como un espejo. Para informar de errores o solicitar funciones, abre un issue.

También estamos contratando desarrolladores nativos de IA. Si quieres ayudar a construir el futuro de la Inteligencia de Aplicaciones con IA, postúlate en appfigures.com/careers.

Licencia

Apache 2.0