YouTube API Key: so bekommst du ihn und was das Tageskontingent zahlt
Ein YouTube API Key kostet vier Schritte in der Google Cloud Console: Projekt anlegen, YouTube Data API v3 aktivieren, Credentials öffnen, Key erstellen. Er liest nur öffentliche Daten. Ein Video hochladen, deine eigenen Analytics lesen oder auf einen Kommentar antworten braucht OAuth 2.0, und was dich wirklich begrenzt, ist das Tageskontingent.
Alles Folgende wurde am 10. November 2026 in der YouTube Data API Dokumentation gelesen.
So bekommst du einen YouTube API Key
Du brauchst ein Google-Konto. Die Console zu öffnen ist kostenlos; die YouTube Data API selbst hat keinen Preis pro Aufruf, nur ein Kontingent.
- Öffne die Google Cloud Console und lege ein Projekt an, oder wähle eines, das dir schon gehört.
- Öffne die API Library und aktiviere YouTube Data API v3. Ist sie nicht aktiviert, antwortet jede Anfrage mit 403, egal wie deine Credentials aussehen.
- Öffne die Seite Credentials.
- Wähle Create credentials > API key. Der Key erscheint sofort.
- Wähle Restrict key, bevor du irgendetwas auslieferst.
Googles eigene Formulierung zu diesem letzten Punkt: «Restrict the key before using it in production.» Zwei Beschränkungen zählen. Eine API-Beschränkung begrenzt den Key auf die YouTube Data API, ein geleakter Key kann also nicht für andere Google-Dienste ausgegeben werden. Eine Anwendungsbeschränkung begrenzt ihn auf die IP-Adressen deines Servers, deine HTTP-Referrer oder die Signatur deiner App.
Der Key geht als URL-Parameter in die Anfrage:
curl "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&id=VIDEO_ID&key=YOUR_API_KEY"
Das heißt, er reist in URLs, in Server-Logs und im Browserverlauf mit. Betrachte ihn als öffentlich, sobald er in Client-Code steht, und halte alles, was dich echtes Kontingent kostet, hinter deinem eigenen Backend.
API Key oder OAuth: die YouTube Credentials, die du wirklich brauchst
Hier verlieren die meisten einen Nachmittag. Der Key ist kein Login. Er identifiziert dein Projekt für Abrechnung und Kontingent, nicht einen Nutzer.
Google formuliert die Regel klar: «Use an API key for requests that only retrieve public data, such as public video metadata or search results.» Für alles andere «must use the OAuth 2.0 protocol», heißt es für deine Anwendung.
| Was du tun willst | Methode | Credential |
|---|---|---|
| Aufrufe und Titel eines öffentlichen Videos lesen | videos.list |
API-Key |
| Öffentliche Videos suchen | search.list |
API-Key |
| Die Abonnentenzahl eines öffentlichen Kanals lesen | channels.list |
API-Key |
| Ein Video hochladen | videos.insert |
OAuth 2.0 |
| Dein eigenes Video aktualisieren oder löschen | videos.update, videos.delete |
OAuth 2.0 |
| Auf einen Kommentar antworten | comments.insert |
OAuth 2.0 |
| Ein Thumbnail setzen | thumbnails.set |
OAuth 2.0 |
Deinen eigenen Kanal lesen mit mine=true |
channels.list |
OAuth 2.0 |
Also: wenn du einen YouTube API Key gesucht hast, weil du einen Bot willst, der deine Videos hochlädt, ist der Key nicht das, was du brauchst. Du brauchst eine OAuth Client ID, einen Consent Screen, ein Refresh Token und, sobald du über Testnutzer hinausgehst, Googles Verifizierungsprüfung. Die Client ID entsteht auf derselben Credentials-Seite: Create credentials > OAuth client ID, und wähle dann den Anwendungstyp.
Die Token-Hälfte dieser Arbeit ist in jedem Netzwerk gleich, und sie ist der Teil, der Monate später weiter kaputtgeht. Social-Media-Access-Tokens behandelt Refresh, Ablauf und stille Trennungen über alle Plattformen hinweg.
Was das Tageskontingent zahlt
YouTube zählt keine Aufrufe, es zählt Einheiten. Die Dokumentation beschreibt die Standardzuteilung in drei Pools:
- 100
search.listAufrufe pro Tag. - 100
videos.insertAufrufe pro Tag. - 10 000 Einheiten pro Tag für alle anderen Endpoints.
Die Kosten in Einheiten, die zählen, direkt aus der Kontingenttabelle:
| Methode | Kosten in Einheiten | Was es macht |
|---|---|---|
videos.list |
1 | Video-Metadaten und Statistiken lesen |
channels.list |
1 | Kanaldaten lesen |
playlists.list |
1 | Playlists lesen |
commentThreads.list |
1 | Kommentare der obersten Ebene lesen |
comments.list |
1 | Antworten lesen |
playlistItems.insert |
50 | Ein Video zu einer Playlist hinzufügen |
comments.insert |
50 | Einen Kommentar oder eine Antwort posten |
thumbnails.set |
50 | Ein eigenes Thumbnail setzen |
captions.insert |
400 | Eine Untertitelspur hochladen |
Reads sind billig, Writes nicht. Ein Untertitel-Upload kostet 400 Einheiten, 25 davon leeren den Hauptpool also allein. Und jede Anfrage zählt, auch die fehlgeschlagenen: eine ungültige Anfrage kostet mindestens eine Einheit, eine Retry-Schleife gegen einen falschen Parameter verbrennt Kontingent also genauso schnell wie echte Arbeit.
Die Kontingentzahlen, die überraschen
Drei Dinge erwischen Teams.
Die Suche hat ihren eigenen Pool, und der ist klein. Hundert search.list Aufrufe pro Tag sind nichts für eine Suchfunktion. Wenn du Suche auf YouTube baust, cachst du die Ergebnisse oder beantragst mehr Kontingent über das Erweiterungsformular. Blättern kostet einen Aufruf pro Seite, ein Nutzer, der vier Seiten scrollt, verbraucht also vier deiner hundert.
Uploads sind nach Anzahl gedeckelt, nicht nach Einheiten. Hundert videos.insert Aufrufe pro Tag klingen großzügig, bis du mehrere Kanäle betreibst. Die Grenze gilt pro Projekt, nicht pro Kanal, zehn Kanäle teilen sich also dieselben hundert.
Das Kontingent wird nach Pazifikzeit zurückgesetzt, nicht nach deiner. Der Tageszähler springt um Mitternacht Pazifikzeit um. Wenn dein Scheduler um Mitternacht in Berlin läuft, verbrauchst du das Kontingent vom Vortag.
Wenn du mehr brauchst, zeigt die Quotas-Seite der Console den Verbrauch, und Google stellt ein Formular zur Kontingenterweiterung bereit. Rechne damit, deinen Anwendungsfall zu beschreiben und zu warten. Die Dokumentation warnt außerdem, dass die Standardzuteilung «subject to change» ist, Grund genug, deinen Einheitenverbrauch zu loggen, statt anzunehmen, dass die heutigen Zahlen ewig gelten.
Auf YouTube und sieben weiteren Netzwerken veröffentlichen
Wenn YouTube die einzige Plattform ist, die du anfasst, bau es selbst: ein OAuth-Client, ein Refresh Token, fertig. Die Rechnung ändert sich, wenn YouTube eines von mehreren Netzwerken ist, denn jede Plattform bringt einen eigenen OAuth-Flow, ein eigenes Review und ein eigenes Kontingentmodell mit. Der Leitfaden zu Social-Media-APIs stellt diese Unterschiede nebeneinander, und die Social-Media-Analytics-API erklärt, warum dieselbe Kennzahl je nach Netzwerk anders aussieht.
Genau diese Lücke füllt PlugKit. Es verbindet Instagram, Facebook, LinkedIn, TikTok, YouTube, X, WhatsApp und Telegram hinter einer REST-API und einem gehosteten MCP-Server unter https://api.plugkit.co/mcp, übernimmt OAuth und das Refresh der Tokens und kostet 49 $ pro Monat für 5 verbundene Accounts, jederzeit kündbar. Sieben Tage gratis, mit Karte bei der Anmeldung und nichts wird vor Tag 7 abgebucht.
Das nimmt dir das YouTube-Kontingent nicht ab, und nichts kann das: das Kontingent gehört dem, dem das API-Projekt gehört. Was es abnimmt, ist die Credential-Arbeit pro Plattform. Wenn du nur öffentliche Video-Metadaten gebraucht hast, bleiben ein schlichter API Key und 30 Zeilen Code die richtige Antwort, und die solltest du nehmen.
FAQ
Ist der YouTube API Key kostenlos?
Ja. Die YouTube Data API hat keinen Preis pro Aufruf. Stattdessen bekommst du ein Tageskontingent, standardmäßig 10 000 Einheiten für allgemeine Endpoints plus getrennte Pools von 100 Suchaufrufen und 100 Uploads. Darüber hinaus heißt eine Erweiterung beantragen, nicht eine Rechnung zahlen.
Kann ich ein Video nur mit einem YouTube API Key hochladen?
Nein. Uploads laufen über videos.insert, und Google verlangt OAuth 2.0 für jedes Insert, Update und Delete. Der API Key identifiziert dein Projekt, er autorisiert keine Aktion auf einem Kanal. Du brauchst eine OAuth Client ID, die Zustimmung des Nutzers und ein Refresh Token.
Wie bekomme ich einen YouTube API Key kostenlos?
Lege ein Google Cloud Projekt an, aktiviere YouTube Data API v3 in der API Library, öffne Credentials und wähle Create credentials, dann API key. Für das Kontingent der Data API wird keine Karte verlangt. Beschränke den Key auf die YouTube Data API, bevor du ihn in Produktion nimmst.
Was passiert, wenn ich das YouTube API Kontingent erreiche?
Anfragen antworten mit 403 und dem Grund quotaExceeded, bis der Zähler um Mitternacht Pazifikzeit zurückgesetzt wird. Nichts wird berechnet und nichts wird schrittweise gedrosselt: du stehst einfach bis zum Reset, und genau deshalb zählt das Bündeln von Reads und das Cachen von Suchergebnissen mehr als das Optimieren einzelner Aufrufe.
Was ist der Unterschied zwischen einem YouTube API Key und OAuth Credentials?
Ein Key identifiziert dein Projekt und liest nur öffentliche Daten. OAuth Credentials identifizieren einen Nutzer, der deiner App Zugriff gegeben hat, und genau das erlaubt dir hochladen, bearbeiten, kommentieren oder private Kanaldaten lesen. Viele Projekte brauchen beides: den Key für öffentliche Reads, OAuth für alles am eigenen Kanal des Nutzers.
Ein Plug für jede Plattform, die dein Agent anfasst
49 $ im Monat für 5 verbundene Accounts, jederzeit kündbar. Jede Funktion in jedem Tarif.
Hol dir deinen API-Key →