API de transcription YouTube en Python : démarrage en 5 minutes

Une requête, une transcription

Le plus court est un GET sur /v1/transcripts/{videoId} avec la clé dans l’en-tête Authorization. La réponse est du JSON : id, langue, durée et liste de segments. Aucun SDK n’est requis — requests ou httpx suffit.

Choisir langue et format

Appelez d’abord /v1/transcripts/{videoId}/languages si la vidéo peut être multilingue, choisissez la piste, puis passez ?lang= et ?format=. Demander srt ou vtt renvoie des sous-titres prêts à enregistrer ; json garde les segments structurés.

Lots et nouvelles tentatives

Pour des listes, envoyez jusqu’à 50 id à /v1/transcripts en un appel et lisez les résultats par élément. Ajoutez un timeout et un léger backoff exponentiel : les ratés transitoires et les 429 passent vite, et chaque réponse porte un X-Request-ID à journaliser.

Gérer les cas délicats

Certaines vidéos n’ont pas de sous-titres, d’autres sont privées ou bloquées par région. L’API répond avec un code typé et un message lisible, donc votre code branche sur le code, pas sur la prose. Journalisez le request id : c’est la voie la plus rapide vers un correctif.