YouTube Transcript API Rate Limit: What It Is and How to Handle 429s

Ini dua batasan berbeda yang sering membingungkan:

• Kuota - total request yang diizinkan dalam jendela waktu lebih panjang (misalnya sehari). Kehabisan berarti menunggu reset, kadang berjam-jam lagi.
• Rate limit - request yang diizinkan per jendela waktu singkat (misalnya semenit). Mengenainya berarti memperlambat selama beberapa detik hingga semenit, bukan berjam-jam.

Di baliknya, kebanyakan API menerapkan rate limiting dengan salah satu dari token bucket (Anda mengumpulkan "token" request pada laju tetap dan menghabiskan satu per request, memungkinkan ledakan singkat) atau counter jendela tetap/bergulir (batas keras per menit kalender, direset pada batas waktunya). Mana yang digunakan sebuah API mengubah seberapa bergelombang traffic Anda bisa aman - token bucket lebih toleran terhadap lonjakan singkat dibanding jendela tetap.

429 Too Many Requests bukan mitos khas satu penyedia saja - ini didefinisikan secara resmi dalam RFC 6585 (April 2012) sebagai kode status HTTP standar. Menurut RFC 9110, server yang mematuhi standar boleh menyertakan header Retry-After pada response 429 (atau 503), dalam salah satu dari dua bentuk:

• Bentuk delay-seconds - sebuah bilangan bulat, misalnya Retry-After: 120, berarti tunggu 120 detik.
• Bentuk HTTP-date - stempel waktu absolut, misalnya Retry-After: Wed, 21 Oct 2026 07:28:00 GMT.

Jika ada, header ini bersifat otoritatif - server memberi tahu Anda persis kapan ia akan menerima request lagi. Jangan menumpuk exponential backoff Anda sendiri di atasnya; itu hanya menunda pemulihan Anda lebih lama lagi. Baru gunakan backoff jika header ini tidak ada.

Urutan langkah yang benar: periksa Retry-After terlebih dahulu, dan baru gunakan exponential backoff dengan jitter jika header itu tidak ada. Jitter (mengacak sedikit waktu tunggu) penting karena saat banyak klien mengenai batas secara bersamaan dan semuanya mencoba ulang dengan jadwal identik, mereka akan tersinkronisasi dan menciptakan "thundering herd" yang langsung memicu ulang batas yang sama.

Node.js:

async function getTranscriptWithRetry(videoId, apiKey, maxRetries = 4) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    const res = await fetch(
      `https://getyoutubetranscript.com/api/v1/transcript?v=${videoId}`,
      { headers: { Authorization: `Bearer ${apiKey}` } }
    );
    if (res.status !== 429) return res.json();

    const retryAfter = res.headers.get('retry-after');
    const waitMs = retryAfter
      ? Number(retryAfter) * 1000
      : 500 * 2 ** attempt + Math.random() * 250; // exponential backoff + jitter
    await new Promise((r) => setTimeout(r, waitMs));
  }
  throw new Error('Rate limited after retries');
}

Python:

import os, time, random, requests

def get_transcript_with_retry(video_id, api_key, max_retries=4):
    url = "https://getyoutubetranscript.com/api/v1/transcript"
    for attempt in range(max_retries + 1):
        res = requests.get(url, params={"v": video_id}, headers={"Authorization": f"Bearer {api_key}"})
        if res.status_code != 429:
            return res.json()

        retry_after = res.headers.get("Retry-After")
        wait = float(retry_after) if retry_after else (0.5 * 2 ** attempt + random.uniform(0, 0.25))
        time.sleep(wait)
    raise RuntimeError("Rate limited after retries")

Batas request per menit dan batas konkurensi yang sedang berjalan bukanlah hal yang sama. Menembakkan 50 request secara bersamaan dengan Promise.all bisa memicu 429 bahkan jika total Anda dalam satu menit masih jauh di bawah anggaran, karena server (atau proxy di depannya) mungkin juga membatasi koneksi simultan. Saat memproses banyak video secara batch, batasi konkurensi secara terpisah dari backoff rate-limit Anda:

import pLimit from 'p-limit';

const limit = pLimit(5); // at most 5 requests in flight at once
const results = await Promise.all(
  videoIds.map((id) => limit(() => getTranscriptWithRetry(id, apiKey)))
);

Untuk batch bervolume tinggi berkelanjutan, meningkatkan tingkat paket langsung menaikkan batas req/menit - lihat harga di dokumentasi API, atau mulai dengan 100 kredit gratis dari dashboard.