Loading...
Loading...
Conéctese con la API externa autenticada o utilice el transporte MCP para agentes y desarrolladores que se basan en el contrato de análisis de YouTube.
Pruebe un punto final en vivo. Reemplace channel_id y YOUR_API_KEY con sus valores:
curl -X GET "https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Accept: application/json"JavaScript
const res = await fetch("https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<id>&range=28d", {
headers: { Authorization: "Bearer <api_key>" }
});
const data = await res.json();Python
import httpx
res = httpx.get(
f"{apiBase}/analytics",
params={"channel_id": "<id>", "range": "28d"},
headers={"Authorization": "Bearer <api_key>"}
)
data = res.json()Cree y revoque claves API desde Panel → Configuración → Claves API, o mediante las rutas autenticadas GET /api/v1/keys y POST /api/v1/keys.
Professional+ planLlame a la API externa en https://www.tubeanalytics.net/api/external/v1 con un token de portador en el encabezado de Autorización.
JSON responsesConecte agentes a https://www.tubeanalytics.net/api/mcp o ejecute npm run mcp:stdio localmente para un transporte stdio.
Agent readyUtilice /openapi.json, /mcp.json y /ai.txt como fuente de verdad legible por máquina para integraciones y agentes.
Machine-readableInicie sesión, complete el flujo de suscripción y conecte un canal desde el panel. La ruta de administración autenticada es GET /api/v1/channels/connect para la cuenta actual y POST /api/v1/channels/connect para conectar o actualizar un canal.
Vaya a Panel → Configuración → Claves API y cree una clave, o utilice la ruta POST /api/v1/keys autenticada. Las claves API están disponibles en los planes Professional y Enterprise.
Utilice la clave de portador en https://www.tubeanalytics.net/api/external/v1. Ejemplo: GET /analytics?channel_id=<id>&range=28d o GET /videos?channel_id=<id>&limit=20.
Para clientes MCP, vaya a https://www.tubeanalytics.net/api/mcp a través de HTTP o ejecute npm run mcp:stdio para el transporte stdio local.
/api/external/v1/channels/api/external/v1/channels/:channelId/api/external/v1/analytics?channel_id=.../api/external/v1/videos?channel_id=.../api/external/v1/audience?channel_id=.../api/external/v1/competitors/api/v1/keys/api/mcpLas solicitudes de API externas deben incluir una clave de API válida en el encabezado de Autorización utilizando el esquema de token de portador. Mantenga la clave del lado del servidor y nunca la exponga en el código del lado del cliente ni la envíe al control de versiones.
Para generar o rotar una clave API, vaya a Panel → Configuración → Claves API. También puede administrar claves desde una sesión autenticada con GET /api/v1/keys, POST /api/v1/keys y DELETE /api/v1/keys/:keyId.
Starter
1 channel · Creators validating one channel before spending more.
Professional
3 channels · Creators and small teams growing more than one channel.
Enterprise
Unlimited channels · Agencies and multi-channel teams with reporting overhead.
curl -X GET https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d \
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de solicitud de API externa. channel_id puede ser el ID de la base de datos interna o el ID del canal de YouTube.
El acceso a API externa está disponible en los planes Professional y Enterprise. Las solicitudes tienen una tarifa limitada por nivel del plan y devuelven 429 con encabezados de límite de tarifa cuando supera el límite.
Encabezados de respuesta de límite de velocidad
Cada respuesta de la API externa incluye estos encabezados para que los clientes puedan gestionar los retrocesos de forma proactiva:
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetRetry-AfterLas solicitudes externas autenticadas utilizan el flujo de claves de Bearer API. Las rutas de administración de solo sesión, como /api/v1/keys y /api/v1/channels/connect, son para la sesión del panel de inicio de sesión, no para llamadas de clave API de servidor a servidor.
La API externa devuelve errores JSON estructurados con error.code y error.message. Es posible que las rutas del panel de control iniciadas aún devuelvan una cadena de error simple, así que verifique la ruta o la especificación de OpenAPI para conocer la forma exacta.
Ejemplo de respuesta de error
{
"error": {
"code": "BAD_REQUEST",
"message": "channel_id query parameter is required"
}
}400401403404429500La mayoría de los puntos finales de API externos aceptan parámetros de consulta comunes para filtrado, paginación y clasificación.
channel_idrangelimitoffsetsortIncorpore métricas de canal a sus propias herramientas: incorpore gráficos en portales internos, informes de clientes o plataformas de BI como Metabase o Grafana.
Programe sincronizaciones nocturnas en Google Sheets, Notion o su almacén llamando a la API externa desde su backend o trabajador de automatización.
Utilice el transporte MCP o el transporte stdio local para brindarles a los agentes acceso al mismo contrato de producto, análisis y datos de cuenta.
Combine datos de API con anuncios, CRM o sistemas financieros para mantener el rendimiento del canal alineado con el resto de su pila.
Utilice estas páginas para pasar del descubrimiento de puntos finales a la integración de producción y la implementación del flujo de trabajo.
Documentos centrales para desarrolladores: autenticación, puntos finales, MCP y archivos de descubrimiento.
Inicio rápido para la primera llamada API, configuración de autenticación y lista de verificación de implementación.
Cargas útiles de eventos y comportamiento de reintento para eventos de datos y suscripción.
Límites de solicitudes según el plan y estrategia de reintento para integraciones estables.
Referencia de implementación específica de integración y alcance de sincronización de datos.
El acceso API está disponible en los planes Professional y Enterprise. Regístrese, conecte un canal, luego cree una clave API y comience a llamar a la API externa o al transporte MCP.