Hent YouTube-transkripsjoner med curl på 30 sekunder

Terminal som henter en YouTube-transkripsjon som tekst

Du trenger verken konto, SDK eller headless-nettleser for å gjøre en YouTube-video om til ren tekst. youtube2text.org er et REST API: ett kall for å få en nøkkel, ett kall for å få transkripsjonen.

Steg 1: Hent den gratis demonøkkelen

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

Respons:

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

Demonøkkelen er delt og IP-begrenset (5 videoer per måned per IP) — perfekt for å prøve seg frem eller til sporadisk skripting.

Steg 2: Hent en transkripsjon

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"

Vellykket respons:

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

Det var alt. Noen detaljer verdt å kjenne til:

url godtar alle YouTube-formater — watch?v=, youtu.be, embed eller en ren 11-tegns video-id.
maxChars kutter transkripsjonen (standard og maks: 150000). Praktisk når du mater teksten inn i en LLM med et token-budsjett.
Authorization: Bearer <key> fungerer som et alternativ til x-api-key.
Foretrekker du POST? Send JSON: {"url": "...", "maxChars": 5000} til samme endepunkt.

Feilhåndtering

Alle feil kommer tilbake i samme maskinlesbare format:

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

Kodene du faktisk kommer til å se:

TRANSCRIPT_UNAVAILABLE — videoen har ingen undertekster i det hele tatt.
RATE_LIMIT_EXCEEDED — kvoten er brukt opp; retryAfterSeconds forteller deg når du kan prøve igjen.
UNAUTHORIZED — manglende eller ugyldig nøkkel; hent en fra /api/demo-key.

Når demonøkkelen ikke strekker til

Logg inn med Google på youtube2text.org/app/keys og opprett din egen nøkkel: gratiskontoen gir også 5 videoer/måned, og betalte planer går fra 50/måned til ubegrenset.

Den komplette maskinlesbare referansen — parametere, alle feilkoder, MCP-integrasjon — finner du på youtube2text.org/api.md. Skal du koble dette til en AI-agent i stedet for et shell-skript, les MCP-guiden etterpå.