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

Bunlar sık sık karıştırılan iki farklı kısıtlamadır:

• Kota - daha uzun bir pencerede (örneğin bir gün) izin verilen toplam istek sayısı. Tükenmesi, saatler sonrasında olabilecek bir sıfırlamayı beklemek anlamına gelir.
• Hız sınırı - kısa bir pencerede (örneğin bir dakika) izin verilen istek sayısı. Buna takılmak, saatler değil, saniyeler ila bir dakika yavaşlamak anlamına gelir.

Perde arkasında, çoğu API hız sınırlamasını ya bir token kovası (sabit bir hızda istek "token"ları biriktirir ve istek başına bir tane harcarsınız, kısa patlamalara izin verir) ya da bir sabit/kayan pencere sayacı (takvim dakikası başına sabit bir tavan, sınırda sıfırlanır) ile uygular. Belirli bir API'nin hangisini kullandığı, trafiğinizin ne kadar patlamalı olabileceğini güvenle değiştirir - bir token kovası, sabit bir pencereden daha iyi kısa bir sıçramaya tolerans gösterir.

429 Too Many Requests, sağlayıcıya özgü bir efsane değil - standart bir HTTP durum kodu olarak resmi olarak RFC 6585'te (Nisan 2012) tanımlanmıştır. RFC 9110'a göre, uyumlu bir sunucu bir 429 (veya 503) yanıtına iki formdan birinde bir Retry-After başlığı ekleyebilir:

• Gecikme saniyesi formu - bir tam sayı, örneğin Retry-After: 120, 120 saniye beklemek anlamına gelir.
• HTTP-tarih formu - mutlak bir zaman damgası, örneğin Retry-After: Wed, 21 Oct 2026 07:28:00 GMT.

Mevcut olduğunda, bu başlık yetkilidir - sunucu size isteklerinizi tekrar ne zaman kabul edeceğini tam olarak söylüyor. Bunun üzerine kendi üstel geri çekilmenizi katmanlamayın; bu yalnızca kurtarmanızı daha da geciktirir. Yalnızca başlık yoksa geri çekilmeye başvurun.

Doğru işlem sırası: önce Retry-After'ı kontrol edin ve yalnızca eksikse jitter ile üstel geri çekilmeye başvurun. Jitter (bekleme süresini biraz rastgeleleştirmek) önemlidir çünkü birçok istemci aynı anda bir sınıra takıldığında ve hepsi aynı programda yeniden denediğinde, senkronize olurlar ve aynı sınırı hemen tekrar tetikleyen bir "kalabalık hücumu" yaratırlar.

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")

Dakika başına istek tavanı ile devam eden eşzamanlılık tavanı aynı şey değildir. Promise.all ile aynı anda 50 istek ateşlemek, dakika için toplamınız bütçenin çok altında olsa bile bir 429'a takılabilir, çünkü sunucu (veya önündeki bir proxy) eşzamanlı bağlantıları da sınırlayabilir. Birçok videoyu toplu işlerken, eşzamanlılığı hız sınırı geri çekilmenizden bağımsız olarak sınırlayın:

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)))
);

Sürekli yüksek hacimli batch'ler için, plan katmanını yükseltmek dakika başına istek tavanını doğrudan yükseltir - API dokümanlarındaki fiyatlandırmaya bakın veya panelden 100 ücretsiz krediyle başlayın.