---
title: "Pregunta a la IA sobre tus datos de analíticas"
description: "Consulta tus analíticas de Adapty en lenguaje natural con un agente de codificación de IA, usando la API de Export Analytics."
---

Pregunta a un agente de codificación con IA sobre tus analíticas de Adapty en lenguaje natural — ingresos, conversiones, retención, LTV — y deja que obtenga los datos por ti. Apunta una herramienta que pueda hacer llamadas a la API hacia la [Export Analytics API](export-analytics-api), y consultará tus métricas bajo demanda.
## Qué puedes consultar \{#what-you-can-ask-about\}

La Export Analytics API devuelve las mismas métricas que ves en los gráficos del Adapty Dashboard. Cada métrica tiene su propia operación:
| Métrica | Qué cubre | Operación |
| --- | --- | --- |
| Ingresos, MRR, ARR, ARPU | Dinero generado a lo largo del tiempo, agrupado por período, país o campaña | [retrieveAnalyticsData](https://adapty.io/docs/es/api-export-analytics/operations/retrieveAnalyticsData.md) |
| Retención de cohortes | Cuánto tiempo siguen pagando los suscriptores de una cohorte determinada | [retrieveCohortData](https://adapty.io/docs/es/api-export-analytics/operations/retrieveCohortData.md) |
| Tasas de conversión | Cuántos usuarios avanzan de un paso o canal al siguiente | [retrieveConversionData](https://adapty.io/docs/es/api-export-analytics/operations/retrieveConversionData.md) |
| Churn y embudo | Dónde abandonan los usuarios y con qué rapidez se dan de baja | [retrieveFunnelData](https://adapty.io/docs/es/api-export-analytics/operations/retrieveFunnelData.md) |
| Valor del ciclo de vida (LTV) | Ingresos medios por segmento de usuarios a lo largo del tiempo | [retrieveLTVData](https://adapty.io/docs/es/api-export-analytics/operations/retrieveLTVData.md) |
| Retención | Porcentaje de usuarios que siguen activos tras un número determinado de días | [retrieveRetentionData](https://adapty.io/docs/es/api-export-analytics/operations/retrieveRetentionData.md) |
Para la lista completa de parámetros y filtros, consulta la [referencia de la API](api-export-analytics).
## Antes de empezar \{#before-you-start\}

Necesitas tres cosas:
- **Una cuenta de Adapty con datos**: La API devuelve las mismas métricas que los gráficos del dashboard, así que tu app ya debe recopilar analíticas.
- **Una clave de API secreta**: Encuéntrala en [App settings → General](https://app.adapty.io/settings/general), en el campo **Secret key**. Las claves son específicas por app, así que usa una clave distinta para cada una. Guárdala en una variable de entorno (por ejemplo, `ADAPTY_SECRET_KEY`) para que tu agente pueda leerla sin que tengas que pegarla en el chat.
- **Una herramienta de IA capaz de llamar APIs**: Por ejemplo, Claude Code, Cursor o Claude Desktop con una herramienta de fetch. Las herramientas de chat básicas como claude.ai o ChatGPT no pueden llamar a la API directamente.
:::note
export-analytics-secret-key.webp
:::
## Dale a tu agente la especificación de la API \{#give-your-agent-the-api-spec\}

La [especificación OpenAPI](https://adapty.io/docs/es/api-specs/export-analytics-api.yaml) describe cada endpoint, la cabecera de autenticación, el cuerpo de la solicitud y ejemplos de respuesta. Una vez que tu agente tenga la especificación, construye solicitudes correctas sin que tengas que escribir ningún código.

Dale a tu agente la especificación mediante la URL:
- **Pega la URL**: Si tu agente puede obtener URLs, dale `https://adapty.io/docs/es/api-specs/export-analytics-api.yaml` y pídele que lea la especificación.
- **Usa una herramienta de fetch**: Si tu agente tiene una herramienta para recuperar URLs (por ejemplo, un servidor MCP de fetch), apúntala a la misma URL.

La especificación establece la URL base en `https://api-admin.adapty.io`, así que tu agente tiene todo lo que necesita una vez que tu clave esté en el entorno.
## Pregunta sobre tus datos \{#ask-about-your-data\}

Con la especificación cargada y tu clave en una variable de entorno, describe en lenguaje natural la métrica que necesitas.

Ejemplos de prompts:
```
What was my MRR at the end of each month this year, and how does it compare to last year?

Show my trial-to-paid conversion rate for the last 90 days, broken down by product.

Which countries drive the most revenue from my yearly subscription? Top 10.

How is week-1 retention trending for subscribers who started in the last 6 months?

What's the refund rate on my annual plan since launch, by month?

Compare LTV for paid-campaign users vs. organic over the last year, and export it as CSV.
```

El agente mapea tu solicitud a la operación correcta, lee la clave del entorno y devuelve los datos. Las respuestas son JSON por defecto. Pide CSV si quieres un archivo listo para hojas de cálculo — el agente establece `format` como `csv` en el cuerpo de la solicitud.

:::warning
Guarda tu clave secreta en una variable de entorno, no la pegues en el chat ni la incluyas en un archivo de reglas. Las claves son específicas de cada app, así que rota la tuya en **Settings → General** si se filtra. Consulta [rotar claves de API](export-analytics-api-authorization#rotate-api-keys).
:::
## Configura una vez para reutilizar \{#set-up-once-for-repeated-use\}

Para no repetir la configuración en cada sesión, guarda la especificación y la clave donde tu agente pueda reutilizarlas:
- **Guarda el enlace de la spec**: Añade la URL de la spec a las reglas o al archivo de memoria de tu agente (por ejemplo, un archivo `CLAUDE.md` o las reglas de Cursor) para que se cargue en cada sesión.
- **Guarda la clave en tu entorno**: Mantén `ADAPTY_SECRET_KEY` en el perfil de tu shell o en el almacén de secretos de la herramienta para no tener que pegarla nunca más.
- **Guarda prompts reutilizables o crea una skill personalizada**: Conserva tus preguntas habituales como prompts guardados, o envuélvelas en una skill personalizada o en un slash command para que tu agente genere un informe cuando lo necesites.
## Límites \{#limits\}

Ten en cuenta estas restricciones:

- **Límite de velocidad**: La API permite 2 solicitudes por segundo por clave de API. Si se supera, devuelve un error `429 Too Many Requests`. Indica a tu agente que espere y reintente en caso de `429`.
- **Claves por aplicación**: Cada clave funciona para una sola aplicación. Para obtener datos de varias aplicaciones, proporciona la clave correspondiente a cada una.
- **Formato de salida**: Las respuestas son JSON por defecto. Establece `format` como `csv` en el cuerpo de la solicitud para exportar en CSV.

Para consultar las reglas completas de autenticación y formato de solicitud, consulta [Autorización y formato de solicitud](export-analytics-api-authorization).