API Tutorial
Cómo obtener analíticas de X por API
Para obtener analíticas de X por API, conecta X a través de Modiva y luego llama a `analytics_unified` — devuelve alcance, impresiones, engagement y métricas de seguidores en una forma normalizada que puedes visualizar o analizar.
Cada plataforma reporta las métricas de forma distinta, así que el reporting entre plataformas suele implicar una capa de mapeo por red. La herramienta `analytics_unified` de Modiva devuelve las métricas de X en el mismo esquema que cualquier otra plataforma, de modo que una sola consulta impulsa un panel entero.
Paso a paso
Crea una cuenta de Modiva y una clave MCP
Regístrate gratis y genera una clave MCP (`mk_live_…`) en el panel. La misma clave autentica tanto el servidor MCP alojado (para agentes de IA) como la API REST (para tu backend), así que solo gestionas una credencial.
Conecta tu cuenta de X
En el panel, haz clic en Conectar y elige X. Modiva ejecuta el flujo de OAuth y solicita los scopes adecuados por ti, luego guarda los tokens de acceso y de actualización en una bóveda cifrada y los mantiene al día — nunca manipulas las credenciales de API sin procesar de X. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Llama a analytics_unified para las métricas de X
Llama a `analytics_unified` con el ID de conexión, las métricas que quieres y un rango de fechas. Modiva las obtiene de X, normaliza los nombres de los campos y devuelve una forma JSON consistente, lista para visualizar.
Agrupa todas las plataformas en un solo informe
Pasa varios ID de conexión para combinar X con el resto de tu stack en una sola respuesta. A través de MCP, un agente puede recuperar las cifras y redactar el informe semanal por ti, y luego llamar a `analytics_best_time_to_post` para programar el siguiente.
Solicitud de ejemplo
Llama a la herramienta analytics_unified a través de la API REST de Modiva. La misma herramienta está disponible para los agentes de IA en el servidor MCP en https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "analytics_unified",
"connectionId": "conn_…",
"args": { "metrics": ["reach", "engagement"], "period": "last_30_days" }
}'Pruébalo con X
Empieza gratisPreguntas frecuentes
¿Son las métricas de X comparables con las de otras plataformas?
Sí — Modiva normaliza las analíticas de X en un esquema común, de modo que el alcance y el engagement encajan a través de cualquier red conectada.
¿Puede un agente de IA elaborar el informe?
Sí. Expón `analytics_unified` a través de MCP y un agente podrá recuperar las cifras de X y redactar el resumen por su cuenta.