YouTube-Transkripte mit curl in 30 Sekunden extrahieren

Terminal ruft ein YouTube-Transkript als Text ab

Du brauchst weder einen Account noch ein SDK oder einen Headless-Browser, um ein YouTube-Video in reinen Text zu verwandeln. youtube2text.org ist eine REST API: ein Aufruf für den Key, ein Aufruf für das Transkript.

Schritt 1: Kostenlosen Demo-Key holen

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

Antwort:

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

Der Demo-Key wird geteilt und ist pro IP limitiert (5 Videos pro Monat und IP) — perfekt zum Ausprobieren oder für gelegentliche Skripte.

Schritt 2: Transkript abrufen

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"

Erfolgreiche Antwort:

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

Das war's schon. Ein paar Details, die du kennen solltest:

url akzeptiert jede YouTube-Form — watch?v=, youtu.be, embed oder eine nackte 11-stellige Video-ID.
maxChars kürzt das Transkript (Standard und Maximum: 150000). Praktisch, wenn du den Text in ein LLM mit begrenztem Token-Budget fütterst.
Authorization: Bearer <key> funktioniert als Alternative zu x-api-key.
Lieber POST? Schick JSON an denselben Endpoint: {"url": "...", "maxChars": 5000}.

Fehlerbehandlung

Jeder Fehler kommt im selben maschinenlesbaren Format zurück:

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

Die Codes, die dir tatsächlich begegnen werden:

TRANSCRIPT_UNAVAILABLE — das Video hat überhaupt keine Untertitel.
RATE_LIMIT_EXCEEDED — Kontingent aufgebraucht; retryAfterSeconds sagt dir, wann du es erneut versuchen kannst.
UNAUTHORIZED — Key fehlt oder ist ungültig; hol dir einen unter /api/demo-key.

Wenn der Demo-Key nicht mehr reicht

Melde dich mit Google unter youtube2text.org/app/keys an und erstelle deinen eigenen Key: Der kostenlose Account bekommt ebenfalls 5 Videos/Monat, und bezahlte Pläne reichen von 50/Monat bis unbegrenzt.

Die komplette maschinenlesbare Referenz — Parameter, jeder Fehlercode, MCP-Integration — findest du unter youtube2text.org/api.md. Wenn du das Ganze in einen KI-Agenten statt in ein Shell-Skript einbaust, lies als Nächstes den MCP-Guide.