YouTube API Quota Exceeded: Causes and Fixes

Setiap proyek Google Cloud mendapat kuota default YouTube Data API v3 sebesar 10.000 unit per hari, direset pada tengah malam waktu Pasifik - tidak ada rollover dan tidak ada cara memicu reset lebih awal. Kuota dilacak per proyek, bukan per API key, jadi membuat key kedua dari proyek yang sama tidak memberi Anda kolam kuota kedua.

Setiap panggilan API menghabiskan unit, bukan request - dan biayanya tidak merata. Berikut gambaran lengkap di seluruh endpoint yang benar-benar digunakan developer:

Dengan 100 unit per pencarian, sebuah proyek bisa menghabiskan seluruh kuota hariannya hanya setelah 100 panggilan search - sebelum satu caption pun diunduh. Ini adalah cara paling umum proyek kecil mencapai batas: mereka bukan membuat 10.000 request, melainkan membuat beberapa ratus request yang mahal. Sebaliknya, videos.list, channels.list, dan playlistItems.list murah, masing-masing 1 unit - jika Anda sudah tahu ID video, channel, atau playlist, panggilan tersebut nyaris tidak mengurangi anggaran harian.

1. Buka Google Cloud Console untuk proyek yang terhubung dengan API key Anda.
2. Buka APIs & Services → YouTube Data API v3 → Quotas & System Limits.
3. Ini menampilkan penggunaan Anda saat ini terhadap Queries per day dan batas per menit, diperbarui dengan sedikit jeda, bukan secara real-time.

Jika Anda sudah mendekati batas sebelum membuat 10.000 request, tampilan ini adalah cara memastikan bahwa masalahnya memang panggilan yang mahal seperti di atas, bukan bug.

Keduanya mengembalikan 403, dan keduanya sering disamaratakan sebagai "error kuota" dalam percakapan sehari-hari, tetapi keduanya masalah berbeda dengan perbaikan berbeda:

• quotaExceeded (alasan: dailyLimitExceeded) - proyek Anda menghabiskan seluruh alokasi unit harian. Tidak ada yang bisa memperbaiki ini kecuali menunggu reset tengah malam Pasifik, mengurangi biaya per panggilan, atau mendapatkan persetujuan peningkatan kuota.
• rateLimitExceeded - Anda mengirim request terlalu cepat dalam jendela waktu singkat, terlepas dari total harian Anda. Ini masalah pengaturan laju, bukan masalah anggaran - lihat panduan rate limit kami untuk cara menanganinya dengan benar lewat backoff.

1. Lakukan caching secara agresif. Kuota dikenakan per panggilan API, bukan per request yang dilihat pengguna - jika Anda mengambil ulang caption video yang sama berulang kali, cache hasilnya (bahkan cache TTL in-memory sederhana) alih-alih memanggil API lagi untuk data yang tidak berubah dari menit ke menit.
2. Hindari search.list di tempat pencarian ID langsung sudah cukup. Jika Anda sudah punya ID video, channel, atau playlist, panggilan .list yang sesuai 100 kali lebih murah daripada pencarian.
3. Batch pencarian ID. videos.list menerima hingga 50 ID yang dipisahkan koma per panggilan dengan biaya 1 unit yang sama seperti satu ID - mengambil 50 video satu per satu alih-alih di-batch 50 kali lebih mahal tanpa alasan.
4. Ajukan peningkatan kuota setelah Anda punya penggunaan produksi nyata sebagai justifikasi, lewat formulir YouTube API Services Audit and Quota Extension yang ditautkan dari halaman kuota Cloud Console. Harapkan tinjauan manual, bukan persetujuan instan.
5. Gunakan API transkrip yang tidak berjalan lewat kuota YouTube Anda sendiri. API GetYouTubeTranscript mengambil transkrip dari infrastrukturnya sendiri alih-alih melakukan proxy ke captions.download dengan key Anda, jadi tidak ada batas harian 10.000 unit yang perlu dikelola - hanya batas laju request milik paket itu sendiri.

cURL:

curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk_live_..."

Node.js:

const res = await fetch(
  "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ",
  { headers: { Authorization: `Bearer ${process.env.GETYOUTUBETRANSCRIPT_API_KEY}` } }
);
const { data } = await res.json();
console.log(data.transcript);

Python:

import os, requests

res = requests.get(
    "https://getyoutubetranscript.com/api/v1/transcript",
    params={"v": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {os.environ['GETYOUTUBETRANSCRIPT_API_KEY']}"},
)
print(res.json()["data"]["transcript"])

Ini menghabiskan 1 kredit dari paket GetYouTubeTranscript Anda, bukan unit dari kuota YouTube Data API proyek Google Cloud Anda. Dapatkan 100 kredit gratis, tanpa perlu kartu, dari dashboard, atau lihat dokumentasi API lengkapnya.