YOUTUBE TRANSCRIPT API · GUIDE

Comment utiliser youtube-transcript-api en Python, et pourquoi échoue-t-il sur mon serveur ?

youtube-transcript-api est une bibliothèque Python gratuite et open source : installez-la avec pip et appelez fetch() avec l'ID d'une vidéo. Elle marche bien sur votre ordinateur, mais sur un serveur cloud YouTube la bloque souvent. Nous l'avons lancée depuis l'un d'eux le 21 novembre 2026 et obtenu IpBlocked sur les deux vidéos.

Mis à jour le 21 novembre 2026 · 6 min de lecture

youtube-transcript-api est une bibliothèque Python gratuite et open source qui récupère les sous-titres d'une vidéo YouTube : pip install youtube-transcript-api, puis YouTubeTranscriptApi().fetch(video_id). Elle fonctionne bien depuis votre ordinateur, mais depuis un serveur cloud YouTube la bloque souvent avec RequestBlocked ou IpBlocked, et elle ne peut rien pour les vidéos sans sous-titres.

Nous l'avons lancée depuis une machine cloud le 21 novembre 2026, puis avons fait passer les deux mêmes vidéos par notre propre API hébergée depuis la même machine. Voici ce qu'a fait chacune, comment utiliser la bibliothèque et quand une API hébergée convient mieux.

Qu'est-ce que youtube-transcript-api ?

C'est une bibliothèque Python de Jonas Depoix, sur GitHub et PyPI, sous licence MIT. La version 1.2.5 est la version actuelle, pour Python 3.8 et plus.

  • Elle lit les sous-titres que YouTube a déjà, ceux de la chaîne ou ceux générés automatiquement.
  • Elle ne demande ni clé d'API ni navigateur headless.
  • Elle peut lister les langues de sous-titres d'une vidéo, préférer une langue à une autre et utiliser la traduction automatique de YouTube.
  • Elle produit du texte, du JSON, du SRT ou du WebVTT, et propose un outil en ligne de commande.

Son README est franc sur le compromis : elle utilise une partie non documentée du lecteur web de YouTube, il n'y a donc « no guarantee that it won't stop working tomorrow ».

Comment l'utiliser ?

pip install youtube-transcript-api
from youtube_transcript_api import YouTubeTranscriptApi
from youtube_transcript_api.formatters import SRTFormatter

ytt_api = YouTubeTranscriptApi()

# English if it exists, else German
transcript = ytt_api.fetch("aircAruvnKk", languages=["en", "de"])

for snippet in transcript:
    print(snippet.start, snippet.text)

print(SRTFormatter().format_transcript(transcript))

En ligne de commande, youtube_transcript_api aircAruvnKk --languages en --format json > transcript.json fait la même chose. Le README couvre la liste des langues, la traduction et le reste.

Pourquoi échoue-t-elle avec IpBlocked sur mon serveur ?

Parce que YouTube bloque la plupart des requêtes venant de fournisseurs cloud. Le README de la bibliothèque le dit clairement : YouTube « has started blocking most IPs that are known to belong to cloud providers (like AWS, Google Cloud Platform, Azure, etc.) », et vous tomberez « most likely » sur des erreurs RequestBlocked ou IpBlocked une fois le code déployé. Une IP personnelle peut aussi être bloquée après trop de requêtes.

Nous l'avons constaté nous-mêmes. Le 21 novembre 2026, nous avons installé la version 1.2.5 sur une machine cloud et demandé deux cours publics :

youtube-transcript-api renvoyant IpBlocked sur une machine cloud, et les deux mêmes vidéos renvoyées par l'API de YouTubeTranscript.dev depuis la même machineMême machine, mêmes deux vidéos, 21 novembre 2026 (UTC).

Les deux appels ont renvoyé IpBlocked en 1,1 seconde environ. Une simple requête vers youtube.com depuis cette machine a été redirigée vers la page « trafic inhabituel » de Google : c'est YouTube qui refusait la machine, pas un bug de la bibliothèque.

La solution du README, ce sont les proxys, et il recommande des proxys résidentiels rotatifs, car YouTube bannit les proxys statiques après un usage prolongé. Cela fonctionne, mais c'est un service payant de plus, un compte de plus et des blocages à surveiller.

Qu'est-ce qui peut encore la bloquer ?

  • Pas de sous-titres. La bibliothèque lit des sous-titres ; elle ne transcrit pas l'audio. Des sous-titres désactivés renvoient TranscriptsDisabled, une langue absente NoTranscriptFound.
  • Vidéos soumises à une limite d'âge. Le README indique que la connexion par cookies, nécessaire pour celles-ci, est « currently not available » après des changements côté YouTube.
  • Changements de YouTube. Comme elle utilise une interface non documentée, une mise à jour de YouTube peut la casser jusqu'à une nouvelle version.

Rien de tout cela n'empêche de l'utiliser pour un script sur votre portable. C'est une raison de le prévoir avant de l'intégrer à un produit.

Que puis-je utiliser quand elle est bloquée ?

Une API de transcription hébergée, qui fait la récupération de son côté. La nôtre est l'API de YouTubeTranscript.dev. Depuis la même machine cloud, quelques minutes plus tôt, les deux mêmes vidéos :

VidéoDuréeTempsMotsLignes horodatéesCrédits
But what is a neural network? (3Blue1Brown)18:404,2 secondes3 3572861
1. What is Computation? (MIT OpenCourseWare)43:064,2 secondes6 3638871
La même vidéo de 3Blue1Brown, redemandée18:401,3 seconde3 3572860

Comment nous avons mesuré : une requête à POST /api/v2/transcribe pour chacune, sous-titres uniquement et horodatages activés, chronométrée par curl de l'envoi à la réponse complète. Les crédits sont ceux indiqués par chaque réponse. Un essai chacune : prenez les durées comme des exemples.

L'appel depuis Python :

import requests

r = requests.post(
    "https://www.youtubetranscript.dev/api/v2/transcribe",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"video": "aircAruvnKk", "mode": "auto", "format": {"timestamp": True}},
)
data = r.json()["data"]
for seg in data["transcript"]["segments"]:
    print(seg["start"], seg["text"])  # start and end are in milliseconds

Le compromis, c'est le coût : la bibliothèque est gratuite, l'API coûte 1 crédit par vidéo sous-titrée, avec 10 crédits gratuits par mois et des offres payantes dès 5 $ pour 500. Avec "mode": "auto", elle transcrit aussi les vidéos sans sous-titres, à 1 crédit pour 2 minutes d'audio. Il existe un SDK Python si vous préférez ne pas écrire la requête vous-même.

Comment intégrer une API de transcription dans mon produit ?

La même méthode marche quelle que soit l'API :

  1. Gardez la clé sur votre serveur. Vos utilisateurs envoient un lien à votre backend, qui appelle l'API. Ne mettez jamais la clé dans le code du navigateur ou de l'application.
  2. Acceptez tous les formats de lien. Transmettez le lien tel que l'utilisateur l'a saisi ; la nôtre accepte les URL complètes, youtu.be, Shorts, les liens embed et les ID seuls (la liste complète).
  3. Stockez la transcription par ID de vidéo. La plupart des produits redemandent sans cesse les mêmes vidéos populaires. Chez nous, une transcription que votre compte a déjà ne coûte rien à récupérer de nouveau, comme le montre la troisième ligne, mais une copie locale est encore plus rapide.
  4. Traitez les vidéos sans sous-titres comme une tâche. La transcription de l'audio prend plus de temps qu'une requête web ne devrait attendre. Envoyez mode: "auto" avec une webhook_url, ou interrogez l'ID de tâche renvoyé, et affichez une progression à l'utilisateur.
  5. Passez en batch quand il y en a beaucoup. Pour une playlist, une chaîne ou un arriéré, utilisez l'endpoint batch plutôt qu'une boucle d'appels, pour rester sous votre limite de débit.

La documentation de l'API détaille chaque champ, et notre guide de l'API de reconnaissance vocale mesure la précision et le coût sur de l'audio sans sous-titres.

Laquelle choisir ?

Si vous...Utilisez
lancez un script sur votre ordinateur, quelques vidéos à la foisyoutube-transcript-api
déployez sur un serveur cloud, une fonction serverless ou un produitUne API hébergée, ou la bibliothèque plus des proxys résidentiels rotatifs
traitez des vidéos sans sous-titresUn service qui transcrit l'audio
récupérez des playlists ou des chaînes entièresUne API hébergée avec endpoint batch

En résumé

  • youtube-transcript-api est gratuite, sous licence MIT et simple : YouTubeTranscriptApi().fetch(video_id).
  • Sur un serveur cloud, YouTube la bloque souvent ; sur notre machine cloud, les deux vidéos ont renvoyé IpBlocked en 1,1 seconde environ. La solution proposée, ce sont les proxys.
  • Elle ne lit que des sous-titres existants, et les vidéos soumises à une limite d'âge sont exclues pour l'instant.
  • Une API hébergée a renvoyé les mêmes vidéos depuis la même machine en 4,2 secondes chacune, pour 1 crédit chacune, et gère les vidéos sans sous-titres.

Questions fréquentes

Qu'est-ce que youtube-transcript-api ?+

Une bibliothèque Python open source (licence MIT) qui récupère les sous-titres qu'une vidéo a déjà sur YouTube, y compris automatiques, sans clé d'API ni navigateur. Installation avec pip install youtube-transcript-api, appel avec YouTubeTranscriptApi().fetch(video_id).

Pourquoi youtube-transcript-api renvoie RequestBlocked ou IpBlocked ?+

Parce que YouTube bloque la plupart des requêtes venant d'adresses IP de fournisseurs cloud, et peut bloquer toute IP qui fait trop de requêtes. Le README de la bibliothèque le dit et suggère des proxys résidentiels rotatifs. Depuis notre machine cloud, le 21 novembre 2026, les deux vidéos testées ont renvoyé IpBlocked en 1,1 seconde environ.

youtube-transcript-api peut-il transcrire une vidéo sans sous-titres ?+

Non. Il lit des sous-titres existants. Une vidéo aux sous-titres désactivés renvoie TranscriptsDisabled, une vidéo sans votre langue NoTranscriptFound. Pour tirer du texte de l'audio, il faut un service de reconnaissance vocale.

youtube-transcript-api est-il gratuit ?+

Oui, la bibliothèque est gratuite et sous licence MIT. Sur un serveur, il faut en général payer des proxys, car les IP cloud sont bloquées.

Que puis-je utiliser à la place de youtube-transcript-api sur un serveur ?+

Une API de transcription hébergée qui fait la récupération pour vous. Depuis la machine où la bibliothèque était bloquée, l'API de YouTubeTranscript.dev a renvoyé les deux vidéos en 4,2 secondes chacune, pour 1 crédit chacune, et une requête répétée en 1,3 seconde gratuitement.

Comment intégrer une API de transcription dans mon produit ?+

Gardez la clé d'API sur votre serveur, envoyez le lien de la vidéo à un endpoint, stockez la transcription par ID de vidéo pour ne jamais payer deux fois, traitez les vidéos sans sous-titres comme une tâche asynchrone avec webhook, et utilisez un endpoint batch pour de nombreuses vidéos.

À lire aussi

Commencez dès maintenant à extraire des transcriptions gratuitement

Convertissez n'importe quelle vidéo YouTube en texte en quelques secondes. Aucune carte de crédit n'est requise.

ESSAYEZ YOUTUBETRANSCRIPT.DEV →
youtube-transcript-api (Python) : utilisation et échecs | Creator Research