YouTube API Quota Exceeded: Causes and Fixes

Jedes Google-Cloud-Projekt erhält ein Standardkontingent der YouTube Data API v3 von 10.000 Einheiten pro Tag, zurückgesetzt um Mitternacht Pacific Time – es gibt keinen Übertrag und keine Möglichkeit, ein vorzeitiges Reset auszulösen. Das Kontingent wird pro Projekt verfolgt, nicht pro API-Schlüssel, sodass die Erstellung eines zweiten Schlüssels im selben Projekt keinen zweiten Pool ergibt.

Jeder API-Aufruf kostet Einheiten, nicht Anfragen – und die Kosten sind ungleich verteilt. Hier die vollständige Übersicht über die Endpunkte, die Entwickler tatsächlich nutzen:

Bei 100 Einheiten pro Suche kann ein Projekt sein gesamtes Tageskontingent bereits nach nur 100 Suchaufrufen aufbrauchen – bevor auch nur ein einziger Untertitel heruntergeladen wurde. Das ist die häufigste Art, wie kleine Projekte an das Limit stoßen: Sie haben nicht 10.000 Anfragen gestellt, sondern ein paar hundert teure. Im Gegensatz dazu sind videos.list, channels.list und playlistItems.list mit je 1 Einheit günstig – kennen Sie bereits eine Video-, Kanal- oder Playlist-ID, belasten diese Aufrufe das Tagesbudget kaum.

1. Öffnen Sie die Google Cloud Console für das Projekt, das mit Ihrem API-Schlüssel verknüpft ist.
2. Gehen Sie zu APIs & Services → YouTube Data API v3 → Quotas & System Limits.
3. Dies zeigt Ihre aktuelle Nutzung gegenüber Queries per day und den Minutenlimits, mit leichter Verzögerung aktualisiert, nicht in Echtzeit.

Wenn Sie sich der Obergrenze bereits nähern, ohne 10.000 Anfragen gestellt zu haben, bestätigt diese Ansicht, dass es sich um das Problem der teuren Aufrufe oben handelt, nicht um einen Fehler.

Beide liefern einen 403 und werden in lockeren Gesprächen oft beide als "Kontingentfehler" zusammengeworfen, sind aber unterschiedliche Probleme mit unterschiedlichen Lösungen:

• quotaExceeded (Grund: dailyLimitExceeded) – Ihr Projekt hat sein volles Tageskontingent aufgebraucht. Nichts behebt das außer dem Warten auf das Mitternachts-Reset in Pacific Time, dem Senken der Kosten pro Aufruf oder einer genehmigten Kontingenterhöhung.
• rateLimitExceeded – Sie senden Anfragen in einem kurzen Fenster zu schnell, unabhängig von Ihrem Tagesgesamtwert. Das ist ein Taktungs-, kein Budgetproblem – siehe unseren Rate-Limit-Leitfaden dafür, wie Sie das korrekt mit Backoff handhaben.

1. Aggressiv cachen. Das Kontingent wird pro API-Aufruf berechnet, nicht pro nutzerseitiger Anfrage – wenn Sie die Untertitel desselben Videos wiederholt abrufen, cachen Sie das Ergebnis (auch ein einfacher In-Memory-TTL-Cache genügt), statt die API erneut für Daten aufzurufen, die sich von Minute zu Minute nicht ändern.
2. Vermeiden Sie search.list, wo eine direkte ID-Abfrage funktioniert. Haben Sie bereits eine Video-, Kanal- oder Playlist-ID, ist der entsprechende .list-Aufruf 100-mal günstiger als eine Suche.
3. ID-Abfragen bündeln. videos.list akzeptiert bis zu 50 kommagetrennte IDs pro Aufruf zu denselben 1-Einheit-Kosten wie eine einzelne ID – 50 Videos einzeln statt gebündelt abzurufen kostet ohne Grund 50-mal so viel.
4. Eine Kontingenterhöhung beantragen, sobald Sie echte Produktionsnutzung zur Begründung haben, über das YouTube API Services Audit and Quota Extension-Formular, das von der Kontingentseite der Cloud Console aus verlinkt ist. Rechnen Sie mit einer manuellen Prüfung, nicht mit sofortiger Genehmigung.
5. Eine Transkript-API nutzen, die nicht über Ihr eigenes YouTube-Kontingent läuft. Die API von GetYouTubeTranscript ruft Transkripte über ihre eigene Infrastruktur ab, statt captions.download mit Ihrem Schlüssel zu proxen, es gibt also keine tägliche 10.000-Einheiten-Obergrenze zu verwalten – nur die eigene Anfragerate des Plans.

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

Das kostet 1 Credit gegen Ihren GetYouTubeTranscript-Plan, keine Einheiten gegen das YouTube-Data-API-Kontingent Ihres Google-Cloud-Projekts. Holen Sie sich 100 kostenlose Credits ohne Kartenangabe über das Dashboard, oder lesen Sie die vollständige API-Dokumentation.