Extraire des transcriptions YouTube avec curl en 30 secondes

Terminal récupérant une transcription YouTube sous forme de texte

Pas besoin de compte, de SDK ni de navigateur headless pour transformer une vidéo YouTube en texte brut. youtube2text.org est une API REST : un appel pour obtenir une clé, un appel pour obtenir la transcription.

Étape 1 : récupérer la clé de démonstration gratuite

curl -s https://youtube2text.org/api/demo-key

Réponse :

{"success": true, "apiKey": "yt_..."}

La clé de démonstration est partagée et limitée par IP (5 vidéos par mois et par IP) — parfaite pour faire des essais ou pour du scripting occasionnel.

Étape 2 : obtenir une transcription

curl -s "https://youtube2text.org/api/transcribe?url=https://www.youtube.com/watch?v=VIDEO_ID&maxChars=5000" \
  -H "x-api-key: yt_YOUR_KEY"

Réponse en cas de succès :

{"result": {"videoId": "...", "title": "...", "pubDate": "2025-01-01T00:00:00-07:00",
            "content": "full transcript text ...", "contentSize": 12345, "truncated": false}}

C'est tout. Quelques détails utiles à connaître :

url accepte n'importe quelle forme d'URL YouTube — watch?v=, youtu.be, embed, ou simplement l'identifiant de vidéo à 11 caractères.
maxChars tronque la transcription (valeur par défaut et maximum : 150000). Pratique quand vous envoyez le texte à un LLM avec un budget de tokens.
Authorization: Bearer <key> fonctionne comme alternative à x-api-key.
Vous préférez POST ? Envoyez du JSON : {"url": "...", "maxChars": 5000} au même endpoint.

Gérer les erreurs

Chaque erreur revient dans le même format lisible par machine :

{"error": {"code": "RATE_LIMIT_EXCEEDED", "message": "...", "status": 429,
           "docsUrl": "https://youtube2text.org/api.md", "retryAfterSeconds": 3600}}

Les codes que vous rencontrerez réellement :

TRANSCRIPT_UNAVAILABLE — la vidéo n'a aucun sous-titre.
RATE_LIMIT_EXCEEDED — quota épuisé ; retryAfterSeconds vous indique quand réessayer.
UNAUTHORIZED — clé absente ou invalide ; récupérez-en une via /api/demo-key.

Quand la clé de démonstration ne suffit plus

Connectez-vous avec Google sur youtube2text.org/app/keys et créez votre propre clé : le compte gratuit donne aussi droit à 5 vidéos/mois, et les formules payantes vont de 50/mois à illimité.

La référence complète lisible par machine — paramètres, tous les codes d'erreur, intégration MCP — se trouve sur youtube2text.org/api.md. Si vous intégrez tout cela dans un agent IA plutôt que dans un script shell, lisez ensuite le guide MCP.