YouTube Transcripts in n8n: HTTP Request Workflow Guide
How to fetch YouTube transcripts inside an n8n workflow using the HTTP Request node - a downloadable workflow JSON, batch processing multiple videos, handling rate limits, and feeding results into an AI summarizer.
00:09:00 · SEP 13, 2026
Réponse rapide
Télécharger le workflow
Importez ceci directement via l'option Import from File de n8n (ou collez-le dans Import from URL) :
Télécharger le workflow (.json)Définir votre clé API
Obtenez une clé depuis le tableau de bord (100 crédits gratuits, sans carte requise), puis définissez-la comme variable d'environnement accessible à votre instance n8n :
GETYOUTUBETRANSCRIPT_API_KEY=sk_live_...Blog.Posts.n8nYoutubeTranscriptWorkflow.step2.body2
Comment le nœud de requête est configuré
Le nœud HTTP Request appelle le point d'accès de transcription avec l'ID de la vidéo comme paramètre de requête :
GET https://getyoutubetranscript.com/api/v1/transcript?v={{ $json.videoId }}
Authorization: Bearer {{ $env.GETYOUTUBETRANSCRIPT_API_KEY }}Injectez un ID de vidéo dans l'entrée du workflow (ou la sortie d'un nœud précédent), et le nœud renvoie la transcription, le titre, l'auteur, et la miniature en JSON à $json.data.transcript.
Traiter plusieurs vidéos sans déclencher la limite de débit
Injecter une liste d'ID de vidéos directement dans le nœud HTTP Request les déclenche toutes aussi vite que n8n le peut - correct pour 5 vidéos, risqué pour 500 face à une limite gratuite de 60 req/min. n8n offre deux moyens intégrés pour cadencer cela :
- Nœud HTTP Request → Add Option → Batching. Définissez Items per Batch (combien de requêtes se déclenchent ensemble) et Batch Interval (ms) (délai entre les lots). Pour la limite de 60 req/min de l'offre gratuite, une taille de lot de 5 avec un intervalle de 5 000 ms reste confortablement sous le budget.
- Split In Batches + nœud Wait. Le nœud Split In Batches divise votre liste de vidéos en morceaux ; un nœud Wait fait une pause entre les morceaux avant que la boucle ne continue vers le suivant. C'est strictement séquentiel (aucune rafale parallèle du tout), ce qui est le choix le plus sûr si vous êtes proche de la limite ou si l'API en aval de la chaîne (par ex. un résumeur LLM) a elle aussi son propre plafond de débit.
Définissez également Wait Between Tries (ms) dans les paramètres de nouvelle tentative du nœud à une valeur supérieure à votre budget par requête - pour une offre de 60 req/min, c'est environ une requête par seconde en moyenne, donc 1 000 ms ou plus entre les tentatives évite de redéclencher immédiatement la même limite sur un 429.
Gérer les échecs dans un lot
Lors du traitement de nombreuses vidéos, certaines échoueront (vidéo privée, pas de sous-titres, un 429 transitoire). Activez Continue On Fail sur le nœud HTTP Request afin qu'un échec n'arrête pas toute l'exécution, puis ajoutez un nœud IF en aval pour brancher sur la réponse - routez les succès vers votre résumeur et les échecs vers un journal ou une file de nouvelle tentative au lieu de perdre tout le lot pour un seul mauvais ID de vidéo.
L'enchaîner avec un résumeur
Blog.Posts.n8nYoutubeTranscriptWorkflow.step6.body
La référence complète des points d'accès, les crédits, et les limites de débit se trouvent dans la documentation API. Vous construisez un agent IA plutôt qu'une automatisation n8n ? Consultez le guide de configuration du serveur MCP.
FAQ sur le workflow n8n
Ai-je besoin d'un nœud n8n personnalisé pour cela ?
Non. L'API est un simple point d'accès REST, donc le nœud HTTP Request intégré de n8n s'en charge directement - aucune installation de nœud communautaire requise.
Comment transmettre la clé API de manière sécurisée ?
Définissez-la comme variable d'environnement n8n (par ex. GETYOUTUBETRANSCRIPT_API_KEY) et référencez-la dans le champ d'en-tête du nœud HTTP Request, plutôt que de coder la clé en dur dans le JSON du workflow.
Quelle est la différence entre l'option Batching du nœud HTTP Request et un nœud Split In Batches ?
Le Batching du nœud HTTP Request (Items per Batch + Batch Interval) envoie plusieurs requêtes en parallèle par lot, espacées par l'intervalle - plus rapide, mais risque de dépasser une limite de débit si la taille du lot est trop élevée. Split In Batches + un nœud Wait traite un lot entièrement, fait une pause, puis reprend pour le suivant - plus lent mais strictement séquentiel, ce qui est plus sûr face à des limites par minute serrées.
Comment éviter d'atteindre la limite de débit lors du traitement de nombreuses vidéos ?
Définissez l'option de nouvelle tentative "Wait Between Tries" du nœud HTTP Request à une valeur supérieure au budget par requête de votre offre - pour l'offre gratuite de 60 req/min (1 requête/seconde en moyenne), cadencez les requêtes à environ 1 000 ms ou plus d'écart, ou moins si vous êtes sur une offre payante à débit plus élevé.
Puis-je enchaîner cela avec une étape de résumé IA ?
Oui - ajoutez un nœud IA/LLM (OpenAI, Anthropic, etc.) après le nœud HTTP Request et référencez {{ $json.data.transcript }} comme entrée pour résumer ou extraire des informations de la transcription renvoyée.
Que se passe-t-il si une vidéo n'a pas de sous-titres ou si la requête échoue ?
Activez "Continue On Fail" sur le nœud HTTP Request si vous traitez un lot de vidéos, afin qu'une mauvaise vidéo n'arrête pas toute l'exécution - puis branchez sur le statut de la réponse en aval (par ex. un nœud IF vérifiant le succès) plutôt que de laisser le workflow s'arrêter.
Combien coûte chaque exécution ?
1 crédit par récupération de transcription réussie, la même comptabilité que d'appeler l'API REST directement. Obtenez 100 crédits gratuits sans carte requise depuis le tableau de bord.
À lire aussi
- YouTube API Quota Exceeded: Causes and Fixes
- YouTube Transcript API Rate Limit: What It Is and How to Handle 429s
- YouTube Transcript MCP Server: Setup Guide for Claude and Other AI Tools
- GetYouTubeTranscript vs TranscriptAPI
- GetYouTubeTranscript vs youtubetotranscript.com
- GetYouTubeTranscript vs youtube-transcript.io