Loading...
Loading...
Connectez-vous à l'API externe authentifiée ou utilisez le transport MCP pour les agents et les développeurs basés sur le contrat d'analyse YouTube.
Essayez un point de terminaison en direct. Remplacez channel_id et YOUR_API_KEY par vos valeurs :
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()Créez et révoquez des clés API depuis Tableau de bord → Paramètres → Clés API, ou via les routes authentifiées GET /api/v1/keys et POST /api/v1/keys.
Professional+ planAppelez l'API externe sur https://www.tubeanalytics.net/api/external/v1 avec un jeton Bearer dans l'en-tête Authorization.
JSON responsesConnectez les agents à https://www.tubeanalytics.net/api/mcp ou exécutez npm run mcp:stdio localement pour un transport stdio.
Agent readyUtilisez /openapi.json, /mcp.json et /ai.txt comme source de vérité lisible par machine pour les intégrations et les agents.
Machine-readableConnectez-vous, terminez le flux d'abonnement et connectez une chaîne à partir du tableau de bord. La route de gestion authentifiée est GET /api/v1/channels/connect pour le compte actuel et POST /api/v1/channels/connect pour connecter ou actualiser un canal.
Accédez à Tableau de bord → Paramètres → Clés API et créez une clé, ou utilisez la route POST /api/v1/keys authentifiée. Les clés API sont disponibles sur les forfaits Professionnel et Entreprise.
Utilisez la clé Bearer contre https://www.tubeanalytics.net/api/external/v1. Exemple : GET /analytics?channel_id=<id>&range=28d ou GET /videos?channel_id=<id>&limit=20.
Pour les clients MCP, pointez vers https://www.tubeanalytics.net/api/mcp via HTTP ou exécutez npm run mcp:stdio pour le transport 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/mcpLes demandes d'API externes doivent inclure une clé API valide dans l'en-tête Authorization à l'aide du schéma de jeton Bearer. Conservez la clé côté serveur et ne l'exposez jamais dans le code côté client ni ne la validez dans le contrôle de version.
Pour générer ou faire pivoter une clé API, accédez à Tableau de bord → Paramètres → Clés API. Vous pouvez également gérer les clés d'une session authentifiée avec GET /api/v1/keys, POST /api/v1/keys et 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
5 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"Exemple de requête API externe. Channel_id peut être l'ID de base de données interne ou l'ID de la chaîne YouTube.
L'accès à l'API externe est disponible sur les forfaits Professionnel et Entreprise. Les requêtes sont limitées en débit par niveau de forfait et renvoient 429 avec des en-têtes de limite de débit lorsque vous dépassez la limite.
En-têtes de réponse à limite de débit
Chaque réponse de l'API externe inclut ces en-têtes afin que les clients puissent gérer les interruptions de manière proactive :
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetRetry-AfterLes requêtes externes authentifiées utilisent le flux de clés de l'API Bearer. Les itinéraires de gestion de session uniquement, tels que /api/v1/keys et /api/v1/channels/connect, sont destinés à la session de tableau de bord connectée, et non aux appels de clé API de serveur à serveur.
L'API externe renvoie des erreurs JSON structurées avec error.code et error.message. Les routes du tableau de bord connectées peuvent toujours renvoyer une chaîne d'erreur simple, alors vérifiez la route ou la spécification OpenAPI pour connaître la forme exacte.
Exemple de réponse d'erreur
{
"error": {
"code": "BAD_REQUEST",
"message": "channel_id query parameter is required"
}
}400401403404429500La plupart des points de terminaison d'API externes acceptent les paramètres de requête courants pour le filtrage, la pagination et le tri.
channel_idrangelimitoffsetsortIntégrez les métriques des canaux dans vos propres outils : intégrez des graphiques dans des portails internes, des rapports clients ou des plateformes de BI comme Metabase ou Grafana.
Planifiez des synchronisations nocturnes dans Google Sheets, Notion ou votre entrepôt en appelant l'API externe depuis votre backend ou votre automatisation.
Utilisez le transport MCP ou le transport stdio local pour permettre aux agents d'accéder aux mêmes données de contrat de produit, d'analyse et de compte.
Combinez les données API avec des publicités, un CRM ou des systèmes financiers pour que les performances de vos canaux restent alignées sur le reste de votre pile.
Utilisez ces pages pour passer de la découverte des points de terminaison à l'intégration de production et au déploiement de flux de travail.
Documents centraux pour les développeurs : fichiers d'authentification, de points de terminaison, MCP et de découverte.
Démarrage rapide pour le premier appel d'API, la configuration de l'authentification et la liste de contrôle de déploiement.
Charges utiles des événements et comportement des nouvelles tentatives pour les événements d’abonnement et de données.
Limites de requêtes tenant compte du plan et stratégie de nouvelle tentative pour des intégrations stables.
Référence d’implémentation spécifique à l’intégration et portée de synchronisation des données.
L'accès à l'API est disponible sur les forfaits Professionnel et Entreprise. Inscrivez-vous, connectez un canal, puis créez une clé API et commencez à appeler l'API externe ou le transport MCP.