Desarrolladores
Documentación, encabezados y descubrimiento de API para desarrolladores
La API externa, el flujo de trabajo de claves API, el transporte MCP y los archivos de descubrimiento legibles por máquina se documentan aquí con las rutas activas utilizadas por el producto.
Claves API
Cree y revoque claves en Panel > Configuración > Claves API, o utilice las rutas de administración iniciadas.
Solo Profesional y Empresarial.
API DESCANSO
Call https://tubeanalytics.net/api/external/v1 with Bearer auth.
Respuestas JSON con errores estructurados.
Transporte MCP
Connect agents to https://tubeanalytics.net/api/mcp or use npm run mcp:stdio.
Compatible con HTTP y stdio transmitibles.
Archivos de descubrimiento
Use /openapi.json, /mcp.json, /ai-pricing.json, and /ai.txt as the machine-readable source of truth.
Siempre al día con las rutas en vivo.
Inicio rápido
Pruebe un punto final en vivo. Reemplace channel_id y YOUR_API_KEY con valores reales:
curl -X GET "https://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://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()channel_id accepts either the TubeAnalytics channel ID or the YouTube channel ID. The same Bearer key works for every external endpoint below. API access requires a Professional or Enterprise plan.Cómo conectarse
Conecte un canal de YouTube en el panel
Los datos de API externos provienen de canales conectados. Inicie sesión, conecte un canal y espere a que se complete la sincronización inicial antes de realizar llamadas de servidor a servidor.
Crear una clave API
Abra Panel > Configuración > Claves API en una cuenta Professional o Enterprise, o llame a POST /api/v1/keys desde una sesión autenticada.
Enviar solicitudes autenticadas por el portador
Autorización de uso: Portador <api_key> en cada solicitud externa. Mantenga las claves en el lado del servidor y no las incruste en el código del cliente.
Utilice archivos de descubrimiento para herramientas y agentes
Extraiga la especificación OpenAPI, el manifiesto MCP, el manifiesto de precios ai y el archivo ai.txt al generar clientes, conectar agentes o validar integraciones.
Puntos finales de referencia
Parámetros de consulta
La mayoría de los puntos finales de API externos aceptan parámetros de consulta comunes para filtrado, paginación y clasificación. El esquema completo por punto final se encuentra en la especificación OpenAPI.
channel_idrangelimitoffsetsortAutenticación y encabezados
Las solicitudes externas utilizan el esquema de claves de la API de portador en el encabezado de Autorización. Mantenga la clave del lado del servidor. Cree y rote claves desde Panel > Configuración > Claves API o las rutas de administración iniciadas.
- Authorization
- Bearer <api_key>
- Accept
- application/json
- Content-Type
- application/json
- Rate-limit headers
- X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
- Retry header
- Retry-After on 429 responses
Rutas de gestión iniciadas
Estas rutas son para sesiones de panel autenticadas, no para clientes API de servidor a servidor:
GET /api/v1/keyslistar claves APIPOST /api/v1/keyscrear una nueva clave APIDELETE /api/v1/keys/:keyIdrevocar una claveGET /api/v1/users/profile and related dashboard session routespermanecer separados
Acceso y límites
La superficie de precios anuncia asignaciones de llamadas API mensuales por plan, mientras que la API externa en vivo impone un límite de solicitudes de ventana deslizante y devuelve encabezados de límite de velocidad en cada respuesta. Tenga ambos en cuenta al crear reintentos de clientes y paneles de cuotas.
En la implementación actual, la API externa devuelve X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset en respuestas exitosas, además de Retry-After cuando una solicitud es limitada.
Formato de error
Las rutas API externas devuelven errores JSON estructurados con error.code y error.message. Utilice el código para pasar al manejo de errores y al mensaje para registros legibles por humanos.
{
"error": {
"code": "BAD_REQUEST",
"message": "channel_id query parameter is required"
}
}Estados comunes
- 400 Parámetros de solicitud faltantes o no válidos
- 401 Clave API faltante o no válida
- 403 Clave API válida pero el plan no es elegible
- 404 Canal conectado o recurso no encontrado
- 429 Límite de tarifa excedido
- 500 Error inesperado del servidor
¿Listo para construir?
Regístrese en un plan Professional o Enterprise para obtener acceso a la API. ¿Ya tienes una cuenta? Vaya al panel para crear claves API.