Ekstrak Transkrip YouTube dengan curl dalam 30 Detik

Terminal yang menarik transkrip YouTube sebagai teks

Anda tidak memerlukan akun, SDK, atau headless browser untuk mengubah video YouTube menjadi teks biasa. youtube2text.org adalah REST API: satu panggilan untuk mendapatkan key, satu panggilan untuk mendapatkan transkrip.

Langkah 1: Ambil demo key gratis

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

Respons:

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

Demo key ini bersifat bersama dan dibatasi per IP (5 video per bulan per IP) — sempurna untuk mencoba-coba atau scripting sesekali.

Langkah 2: Ambil transkrip

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"

Respons sukses:

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

Selesai. Beberapa detail yang perlu diketahui:

url menerima segala bentuk tautan YouTube — watch?v=, youtu.be, embed, atau video id 11 karakter saja.
maxChars memotong transkrip (default dan maksimum: 150000). Berguna saat Anda memasukkan teks ke LLM dengan anggaran token terbatas.
Authorization: Bearer <key> dapat digunakan sebagai alternatif dari x-api-key.
Lebih suka POST? Kirim JSON: {"url": "...", "maxChars": 5000} ke endpoint yang sama.

Menangani error

Setiap error dikembalikan dalam bentuk yang sama dan dapat dibaca mesin:

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

Kode yang benar-benar akan Anda temui:

TRANSCRIPT_UNAVAILABLE — video tidak memiliki caption sama sekali.
RATE_LIMIT_EXCEEDED — kuota habis; retryAfterSeconds memberi tahu kapan harus mencoba lagi.
UNAUTHORIZED — key tidak ada atau tidak valid; ambil dari /api/demo-key.

Ketika demo key tidak lagi cukup

Masuk dengan Google di youtube2text.org/app/keys dan buat key Anda sendiri: akun gratis juga mendapat 5 video/bulan, dan paket berbayar mulai dari 50/bulan hingga tanpa batas.

Referensi lengkap yang dapat dibaca mesin — parameter, semua kode error, integrasi MCP — tersedia di youtube2text.org/api.md. Jika Anda menghubungkan ini ke AI agent alih-alih shell script, baca panduan MCP berikutnya.