YouTube-Transkript-API in Python: Quickstart in 5 Minuten

Eine Anfrage, ein Transkript

Der kürzeste Weg ist ein GET auf /v1/transcripts/{videoId} mit dem Schlüssel im Authorization-Header. Die Antwort ist JSON: Video-ID, Sprache, Dauer und Segmentliste. Kein SDK nötig — requests oder httpx genügt.

Sprache und Format wählen

Rufe zuerst /v1/transcripts/{videoId}/languages auf, wenn ein Video mehrsprachig sein kann, wähle die Spur und übergib ?lang= und ?format=. srt oder vtt liefern speicherfertige Untertitel; json behält die strukturierten Segmente.

Batching und Retries

Für Listen sende bis zu 50 IDs in einem POST an /v1/transcripts und lies die Ergebnisse pro Element. Setze Timeout und kleines exponentielles Backoff: kurze Aussetzer und 429er klären sich schnell, und jede Antwort trägt eine X-Request-ID zum Loggen.

Die schwierigen Fälle

Manche Videos haben keine Untertitel, andere sind privat oder regionsgesperrt. Die API antwortet mit typisiertem Fehlercode und lesbarer Meldung, sodass dein Code auf den Code statt auf Prosa reagiert. Logge die Request-ID — das ist der schnellste Weg zur Lösung.