Poimi YouTube-transkriptiot curlilla 30 sekunnissa

Terminaali noutaa YouTube-transkription tekstinä

Et tarvitse tiliä, SDK:ta tai headless-selainta muuttaaksesi YouTube-videon pelkäksi tekstiksi. youtube2text.org on REST API: yksi kutsu avaimen hakemiseen, yksi kutsu transkription hakemiseen.

Vaihe 1: Nouda ilmainen demoavain

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

Vastaus:

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

Demoavain on jaettu ja IP-rajoitettu (5 videota kuukaudessa per IP) — täydellinen kokeiluun tai satunnaiseen skriptaukseen.

Vaihe 2: Hae transkriptio

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"

Onnistunut vastaus:

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

Siinä kaikki. Muutama yksityiskohta, jotka kannattaa tietää:

url hyväksyy minkä tahansa YouTube-muodon — watch?v=, youtu.be, embed tai pelkän 11-merkkisen videotunnisteen.
maxChars katkaisee transkription (oletus ja maksimi: 150000). Kätevä, kun syötät tekstiä LLM:lle, jolla on rajallinen token-budjetti.
Authorization: Bearer <key> toimii vaihtoehtona x-api-key-otsakkeelle.
Suositko POSTia? Lähetä JSON: {"url": "...", "maxChars": 5000} samaan päätepisteeseen.

Virheiden käsittely

Jokainen virhe palautuu samassa koneluettavassa muodossa:

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

Koodit, joita todella tulet näkemään:

TRANSCRIPT_UNAVAILABLE — videolla ei ole lainkaan tekstityksiä.
RATE_LIMIT_EXCEEDED — kiintiö käytetty; retryAfterSeconds kertoo, milloin voit yrittää uudelleen.
UNAUTHORIZED — avain puuttuu tai on virheellinen; nouda uusi osoitteesta /api/demo-key.

Kun demoavain ei riitä

Kirjaudu sisään Google-tilillä osoitteessa youtube2text.org/app/keys ja luo oma avaimesi: ilmainen tili saa myös 5 videota/kk, ja maksulliset paketit ulottuvat 50 videosta/kk rajattomaan.

Täydellinen koneluettava referenssi — parametrit, kaikki virhekoodit, MCP-integraatio — löytyy osoitteesta youtube2text.org/api.md. Jos olet kytkemässä tätä AI-agenttiin shell-skriptin sijaan, lue seuraavaksi MCP-opas.