Pobieranie transkrypcji z YouTube przez curl w 30 sekund

Terminal pobierający transkrypcję z YouTube jako tekst

Nie potrzebujesz konta, SDK ani przeglądarki headless, żeby zamienić film z YouTube na zwykły tekst. youtube2text.org to REST API: jedno wywołanie, żeby dostać klucz, drugie, żeby pobrać transkrypcję.

Krok 1: Pobierz darmowy klucz demo

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

Odpowiedź:

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

Klucz demo jest współdzielony i limitowany per IP (5 filmów miesięcznie na IP) — idealny do testów albo okazjonalnych skryptów.

Krok 2: Pobierz transkrypcję

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"

Odpowiedź w przypadku sukcesu:

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

To wszystko. Kilka szczegółów wartych zapamiętania:

url akceptuje każdą formę adresu YouTube — watch?v=, youtu.be, embed albo samo 11-znakowe id filmu.
maxChars przycina transkrypcję (domyślnie i maksymalnie: 150000). Przydatne, gdy przekazujesz tekst do LLM z ograniczonym budżetem tokenów.
Authorization: Bearer <key> działa jako alternatywa dla x-api-key.
Wolisz POST? Wyślij JSON: {"url": "...", "maxChars": 5000} na ten sam endpoint.

Obsługa błędów

Każdy błąd wraca w tej samej, czytelnej maszynowo strukturze:

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

Kody, które faktycznie zobaczysz:

TRANSCRIPT_UNAVAILABLE — film w ogóle nie ma napisów.
RATE_LIMIT_EXCEEDED — limit wyczerpany; retryAfterSeconds mówi, kiedy ponowić próbę.
UNAUTHORIZED — brakujący lub nieprawidłowy klucz; pobierz go z /api/demo-key.

Gdy klucz demo przestaje wystarczać

Zaloguj się przez Google na youtube2text.org/app/keys i utwórz własny klucz: darmowe konto również daje 5 filmów miesięcznie, a płatne plany zaczynają się od 50 miesięcznie aż po nielimitowane.

Kompletna, czytelna maszynowo dokumentacja — parametry, wszystkie kody błędów, integracja MCP — znajduje się pod adresem youtube2text.org/api.md. Jeśli podłączasz to do agenta AI zamiast do skryptu w shellu, przeczytaj następnie przewodnik po MCP.