youtube-transcript-api ist eine kostenlose Open-Source-Bibliothek für Python, die die Untertitel eines YouTube-Videos abruft: pip install youtube-transcript-api, dann YouTubeTranscriptApi().fetch(video_id). Auf dem eigenen Rechner funktioniert sie gut, aber von einem Cloud-Server aus blockiert YouTube sie oft mit RequestBlocked oder IpBlocked, und bei Videos ohne Untertitel hilft sie nicht.
Wir haben sie am 21. November 2026 auf einer Cloud-Maschine ausgeführt und dann dieselben zwei Videos von derselben Maschine durch unsere eigene gehostete API geschickt. Hier steht, was jeweils passierte, wie man die Bibliothek nutzt und wann eine gehostete API besser passt.
Was ist youtube-transcript-api?
Eine Python-Bibliothek von Jonas Depoix, auf GitHub und PyPI, unter MIT-Lizenz. Aktuell ist Version 1.2.5, für Python 3.8 und neuer.
- Sie liest die Untertitel, die YouTube schon hat, die eigenen des Kanals oder die automatischen von YouTube.
- Sie braucht weder API-Schlüssel noch Headless-Browser.
- Sie listet die Untertitelsprachen eines Videos, bevorzugt eine Sprache vor einer anderen und nutzt YouTubes maschinelle Übersetzung.
- Sie gibt Text, JSON, SRT oder WebVTT aus und hat ein Kommandozeilen-Tool.
Ihr README ist offen über den Kompromiss: Sie nutzt einen undokumentierten Teil von YouTubes Web-Player, es gibt also "no guarantee that it won't stop working tomorrow".
Wie benutze ich sie?
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))
Auf der Kommandozeile macht youtube_transcript_api aircAruvnKk --languages en --format json > transcript.json dasselbe. Das README erklärt Sprachlisten, Übersetzung und den Rest.
Warum scheitert sie auf meinem Server mit IpBlocked?
Weil YouTube die meisten Anfragen von Cloud-Anbietern blockiert. Das README der Bibliothek sagt es deutlich: YouTube "has started blocking most IPs that are known to belong to cloud providers (like AWS, Google Cloud Platform, Azure, etc.)", sodass Sie nach dem Deployment "most likely" auf RequestBlocked- oder IpBlocked-Fehler stoßen. Auch eine private IP kann nach zu vielen Anfragen gesperrt werden.
Wir haben es selbst gesehen. Am 21. November 2026 haben wir Version 1.2.5 auf einer Cloud-Maschine installiert und zwei öffentliche Vorlesungen abgefragt:
Dieselbe Maschine, dieselben zwei Videos, 21. November 2026 (UTC).
Beide Aufrufe meldeten nach etwa 1,1 Sekunden IpBlocked. Eine einfache Anfrage an youtube.com von dieser Maschine wurde auf Googles Seite für "ungewöhnlichen Datenverkehr" umgeleitet; YouTube hat also die Maschine abgewiesen, es war kein Fehler der Bibliothek.
Die Lösung im README sind Proxys, und es empfiehlt rotierende Residential-Proxys, weil YouTube statische Proxys nach längerer Nutzung sperrt. Das funktioniert, bedeutet aber einen weiteren bezahlten Dienst, ein weiteres Konto und Sperren, die man im Blick behalten muss.
Was kann sie sonst noch stoppen?
- Keine Untertitel. Die Bibliothek liest Untertitel; sie transkribiert keinen Ton. Deaktivierte Untertitel lösen
TranscriptsDisabledaus, eine fehlende SpracheNoTranscriptFound. - Altersbeschränkte Videos. Laut README ist die Anmeldung per Cookie, die diese Videos brauchen, nach Änderungen bei YouTube "currently not available".
- Änderungen bei YouTube. Weil sie eine undokumentierte Schnittstelle nutzt, kann ein Update bei YouTube sie brechen, bis eine neue Version erscheint.
Nichts davon spricht gegen sie für ein Skript auf Ihrem Laptop. Es spricht dafür, das einzuplanen, bevor Sie sie in ein Produkt einbauen.
Was kann ich stattdessen nutzen, wenn sie blockiert wird?
Eine gehostete Transkript-API, die das Abrufen auf ihrer Seite erledigt. Unsere ist die API von YouTubeTranscript.dev. Von derselben Cloud-Maschine, ein paar Minuten vorher, dieselben zwei Videos:
| Video | Länge | Zeit | Wörter | Zeilen mit Zeitstempel | Credits |
|---|---|---|---|---|---|
| But what is a neural network? (3Blue1Brown) | 18:40 | 4,2 Sekunden | 3.357 | 286 | 1 |
| 1. What is Computation? (MIT OpenCourseWare) | 43:06 | 4,2 Sekunden | 6.363 | 887 | 1 |
| Dasselbe Video von 3Blue1Brown, erneut angefragt | 18:40 | 1,3 Sekunden | 3.357 | 286 | 0 |
So haben wir gemessen: je eine Anfrage an POST /api/v2/transcribe, nur Untertitel, Zeitstempel an, von curl vom Senden bis zur vollständigen Antwort gemessen. Die Credits sind das, was jede Antwort gemeldet hat. Je ein Durchlauf, die Zeiten sind also Beispiele.
Der Aufruf aus 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
Der Kompromiss sind die Kosten: Die Bibliothek ist kostenlos, die API kostet 1 Credit pro Video mit Untertiteln, mit 10 kostenlosen Credits im Monat und Bezahlplänen ab 5 $ für 500. Mit "mode": "auto" transkribiert sie auch Videos ohne Untertitel, für 1 Credit pro 2 Minuten Ton. Es gibt ein Python-SDK, falls Sie die Anfrage nicht selbst schreiben möchten.
Wie binde ich eine Transkriptions-API in mein Produkt ein?
Dasselbe Muster funktioniert mit jeder API:
- Den Schlüssel auf dem Server behalten. Ihre Nutzer schicken einen Link an Ihr Backend; Ihr Backend ruft die API auf. Legen Sie den Schlüssel nie in Browser- oder App-Code.
- Jedes Linkformat annehmen. Reichen Sie den Link so weiter, wie der Nutzer ihn eingegeben hat; unsere API nimmt vollständige URLs, youtu.be, Shorts, Embeds und reine IDs (die vollständige Liste).
- Das Transkript nach Video-ID speichern. Die meisten Produkte fragen immer wieder dieselben beliebten Videos an. Bei uns kostet ein Transkript, das Ihr Konto schon hat, beim erneuten Abruf nichts, wie die dritte Zeile oben zeigt, aber eine lokale Kopie ist noch schneller.
- Videos ohne Untertitel als Auftrag behandeln. Transkription aus dem Ton dauert länger, als eine Web-Anfrage warten sollte. Senden Sie
mode: "auto"mit einerwebhook_urloder fragen Sie die zurückgegebene Job-ID ab, und zeigen Sie dem Nutzer einen Fortschritt. - Bei vielen Videos Batches nutzen. Für eine Playlist, einen Kanal oder einen Rückstand nutzen Sie den Batch-Endpunkt statt einer Schleife aus Einzelaufrufen, damit Sie im Rate-Limit bleiben.
Die API-Dokumentation beschreibt jedes Feld, und unser Leitfaden zur Speech-to-Text-API misst Genauigkeit und Kosten bei Ton ohne Untertitel.
Was sollte ich nutzen?
| Wenn Sie... | Nutzen Sie |
|---|---|
| ein Skript auf Ihrem eigenen Rechner ausführen, wenige Videos auf einmal | youtube-transcript-api |
| auf einen Cloud-Server, eine Serverless-Funktion oder in ein Produkt deployen | Eine gehostete API, oder die Bibliothek plus rotierende Residential-Proxys |
| Videos ohne Untertitel verarbeiten | Einen Dienst, der Ton transkribiert |
| ganze Playlists oder Kanäle abrufen | Eine gehostete API mit Batch-Endpunkt |
Zusammenfassung
- youtube-transcript-api ist kostenlos, MIT-lizenziert und einfach:
YouTubeTranscriptApi().fetch(video_id). - Auf einem Cloud-Server blockiert YouTube sie oft; auf unserer Cloud-Maschine meldeten beide Videos nach etwa 1,1 Sekunden
IpBlocked. Die vorgeschlagene Lösung sind Proxys. - Sie liest nur vorhandene Untertitel, und altersbeschränkte Videos gehen derzeit nicht.
- Eine gehostete API lieferte dieselben Videos von derselben Maschine in je 4,2 Sekunden für je 1 Credit und kann auch Videos ohne Untertitel verarbeiten.
Häufige Fragen
Was ist youtube-transcript-api?+
Eine Open-Source-Bibliothek für Python (MIT-Lizenz), die die Untertitel abruft, die YouTube für ein Video schon hat, auch automatische, ohne API-Schlüssel und ohne Browser. Installation mit pip install youtube-transcript-api, Aufruf mit YouTubeTranscriptApi().fetch(video_id).
Warum meldet youtube-transcript-api RequestBlocked oder IpBlocked?+
Weil YouTube die meisten Anfragen von IP-Adressen der Cloud-Anbieter blockiert und jede IP sperren kann, die zu viele Anfragen stellt. Das README der Bibliothek sagt das selbst und empfiehlt rotierende Residential-Proxys. Von unserer Cloud-Maschine aus meldeten am 21. November 2026 beide getesteten Videos nach etwa 1,1 Sekunden IpBlocked.
Kann youtube-transcript-api ein Video ohne Untertitel transkribieren?+
Nein. Sie liest vorhandene Untertitel. Ein Video mit deaktivierten Untertiteln löst TranscriptsDisabled aus, eines ohne Ihre Sprache NoTranscriptFound. Für Text aus dem Ton brauchen Sie einen Speech-to-Text-Dienst.
Ist youtube-transcript-api kostenlos?+
Ja, die Bibliothek ist kostenlos und MIT-lizenziert. Auf einem Server bedeutet sie meist Kosten für Proxys, weil Cloud-IPs blockiert werden.
Was kann ich auf einem Server statt youtube-transcript-api nutzen?+
Eine gehostete Transkript-API, die das Abrufen für Sie übernimmt. Von derselben Maschine, auf der die Bibliothek blockiert wurde, lieferte die API von YouTubeTranscript.dev beide Videos in je 4,2 Sekunden für je 1 Credit, und eine wiederholte Anfrage in 1,3 Sekunden kostenlos.
Wie binde ich eine Transkriptions-API in mein Produkt ein?+
Behalten Sie den API-Schlüssel auf Ihrem Server, senden Sie den Videolink an einen Endpunkt, speichern Sie das Transkript nach Video-ID, damit Sie nie doppelt zahlen, behandeln Sie Videos ohne Untertitel als asynchronen Auftrag mit Webhook und nutzen Sie für viele Videos einen Batch-Endpunkt.