API Tutorial
Cómo obtener analíticas de YouTube por API
Para obtener analíticas de YouTube por API, conecta YouTube 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 YouTube 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 YouTube
En el panel, haz clic en Conectar y elige YouTube. 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 YouTube. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Llama a analytics_unified para las métricas de YouTube
Llama a `analytics_unified` con el ID de conexión, las métricas que quieres y un rango de fechas. Modiva las obtiene de YouTube, 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 YouTube 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 YouTube
Empieza gratisPreguntas frecuentes
¿Son las métricas de YouTube comparables con las de otras plataformas?
Sí — Modiva normaliza las analíticas de YouTube 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 YouTube y redactar el resumen por su cuenta.