How to Get YouTube Transcripts in Python

youtube-transcript-api ist ein gut gepflegtes Python-Paket, das die eigenen Untertiteldaten von YouTube direkt abruft - kein API-Schlüssel, kein YouTube-Data-API-Kontingent.

pip install youtube-transcript-api

Ein Transkript mit einer Video-ID abrufen:

from youtube_transcript_api import YouTubeTranscriptApi

api = YouTubeTranscriptApi()
transcript = api.fetch("dQw4w9WgXcQ", languages=["en"])

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

Auf einem Laptop funktioniert das zuverlässig. Auf einem Cloud-Server deployt, kann es auf echte, gut dokumentierte Fehler stoßen - IP-Blockierung, PoTokenRequired, und ein 'Untertitel deaktiviert'-Fehler, der nicht immer das ist, was er zu sein scheint. Die vollständige Diagnose-Checkliste nennt die genauen Ursachen und Lösungen.

Hol dir einen kostenlosen Schlüssel im Dashboard - 100 kostenlose Credits, keine Kreditkarte nötig.

pip install requests

Kein Proxy-Pool, keine Wartung von IP-Blockaden - nur eine HTTP-Anfrage:

import requests

response = requests.get(
    "https://getyoutubetranscript.com/api/v1/transcript",
    params={"v": "dQw4w9WgXcQ"},
    headers={"Authorization": "Bearer sk_live_..."},
)
result = response.json()

print(result["data"]["transcript"])
print(result["data"]["word_count"])

Eine fehlgeschlagene Anfrage liefert ein Fehlerobjekt zurück, statt eine bibliotheksspezifische Exception zu werfen - dieselbe Fehlerbehandlung funktioniert also bei jedem Endpoint.

{ "success": false, "code": "...", "message": "..." }

Über eine Liste von Video-IDs zu iterieren funktioniert genauso - achte nur auf das Requests-pro-Minute-Limit deines Plans. Der Rate-Limit-Guide erklärt Backoff- und Retry-Logik.