Hämta YouTube-transkriptioner med curl på 30 sekunder

Terminal som hämtar en YouTube-transkription som text

Du behöver varken konto, SDK eller headless-webbläsare för att förvandla en YouTube-video till ren text. youtube2text.org är ett REST-API: ett anrop för att få en nyckel, ett anrop för att få transkriptionen.

Steg 1: Hämta den kostnadsfria demonyckeln

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

Svar:

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

Demonyckeln är delad och IP-begränsad (5 videor per månad och IP) — perfekt för att testa eller för enstaka skript.

Steg 2: Hämta en transkription

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"

Svar vid lyckat anrop:

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

Det är allt. Några detaljer som är bra att känna till:

url accepterar alla YouTube-format — watch?v=, youtu.be, embed eller ett rent 11-teckens video-id.
maxChars kapar transkriptionen (standard och max: 150000). Praktiskt när du matar in texten i en LLM med en tokenbudget.
Authorization: Bearer <key> fungerar som ett alternativ till x-api-key.
Föredrar du POST? Skicka JSON: {"url": "...", "maxChars": 5000} till samma endpoint.

Felhantering

Alla fel returneras i samma maskinläsbara format:

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

Felkoderna du faktiskt kommer att stöta på:

TRANSCRIPT_UNAVAILABLE — videon saknar helt undertexter.
RATE_LIMIT_EXCEEDED — kvoten är förbrukad; retryAfterSeconds anger när du kan försöka igen.
UNAUTHORIZED — nyckeln saknas eller är ogiltig; hämta en från /api/demo-key.

När demonyckeln inte räcker till

Logga in med Google på youtube2text.org/app/keys och skapa en egen nyckel: gratiskontot ger också 5 videor/månad, och betalplanerna sträcker sig från 50/månad till obegränsat.

Den kompletta maskinläsbara referensen — parametrar, alla felkoder, MCP-integration — finns på youtube2text.org/api.md. Om du kopplar in det här i en AI-agent i stället för ett skalskript, läs MCP-guiden härnäst.