techhorizonlabs/youtube-channel-profile

YouTube-Kanalprofil

scripts/channel_profile.py liest öffentliche Kanaldaten über die YouTube Data API v3 und gibt einen Markdown-Bericht aus, oder JSON mit --json. Es verwendet ausschließlich die offizielle API. Es lädt niemals YouTube-Webseiten und schreibt nichts auf die Festplatte.

Vor der Ausführung

1. Der Benutzer benötigt ein Google Cloud-Projekt mit aktivierter YouTube Data API v3 und einem API-Schlüssel, der auf diese API beschränkt ist.
2. Der Schlüssel befindet sich in der Umgebungsvariable YOUTUBE_API_KEY. Setzen Sie ihn niemals in eine Eingabeaufforderung, Datei oder Chat und geben Sie ihn niemals aus. Wenn er nicht gesetzt ist, stoppen Sie und bitten Sie den Benutzer, ihn zu setzen. Suchen Sie nicht an anderen Stellen nach Schlüsseln.
3. Installieren Sie die eine Abhängigkeit: pip install -r scripts/requirements.txt (requests).

Ausführen

python3 scripts/channel_profile.py @handle
python3 scripts/channel_profile.py https://www.youtube.com/@handle --videos 100
python3 scripts/channel_profile.py UCxxxxxxxxxxxxxxxxxxxxxx --json

Optionen: --videos N (neueste Uploads zum Lesen, Standard 50, max. 500), --json, --no-search, --cpm-low und --cpm-high (Standard 0.25 und 4.00).

So findet es den Kanal

• Eine Kanal-ID oder eine /channel/UC...-URL: channels.list mit id.
• Ein @handle oder /@handle-URL: channels.list mit forHandle.
• Eine /user/-URL: forUsername. Eine /c/-URL wird als Handle versucht.
• Wenn nichts übereinstimmt, fällt es auf search.list für die beste Übereinstimmung zurück und gibt dies im Bericht an. Überprüfen Sie Titel und ID, bevor Sie sich darauf verlassen. --no-search deaktiviert den Fallback.
• Videolinks, Playlist-Links und Nicht-YouTube-Adressen werden abgelehnt. Fragen Sie nach dem Kanallink.

Kontingent

Aufruf	Kosten
channels.list	1 Einheit
playlistItems.list	1 Einheit pro 50 Uploads
videos.list	1 Einheit pro 50 Videos
search.list (nur Fallback)	1 Aufruf aus eigenem Bucket

Der Standardlauf kostet 3 Einheiten des täglichen Standardkontingents von 10.000 Einheiten. Seit dem 1. Juni 2026 hat search.list einen eigenen Bucket von 100 Aufrufen pro Tag. Davor kostete eine Suche 100 Einheiten aus dem Hauptkontingent, daher werden ältere Anleitungen 100 angeben. Fehlgeschlagene Aufrufe kosten trotzdem Kontingent. Das Kontingent wird um Mitternacht Pazifischer Zeit zurückgesetzt. Jeder Bericht endet mit dem verbrauchten Kontingent.

Was es berichtet

Von YouTube, wie zurückgegeben:

• Abonnenten, von YouTube auf drei signifikante Stellen abgerundet. Wenn der Besitzer die Anzahl versteckt, sagt der Bericht "Versteckt" und gibt keine Schätzung ab.
• Gesamtkanalaufrufe und die Anzahl öffentlicher Videos.
• Aufrufe, Likes und Kommentare für jedes aktuelle Video.

Vom Skript abgeleitet, mit * gekennzeichnet:

• Rhythmus: Median der Tage zwischen den letzten N Uploads, Uploads pro Monat ((N - 1) Lücken / überspannte Tage x 30,44) und Tage seit dem letzten Upload.
• Median und Durchschnitt der Aufrufe aktueller Videos. Live-Streams und zukünftige Streams werden ausgelassen.
• Trend: Median der Aufrufe der letzten 10 Uploads im Vergleich zu den 10 davor. Neuere Videos hatten weniger Zeit, Aufrufe zu sammeln.
• Engagement: Pro Video (Likes + Kommentare) / Aufrufe, dann der Median. Videos mit versteckten Likes werden ausgelassen. Videos mit deaktivierten Kommentaren zählen 0 Kommentare.
• Shorts im Vergleich zu Langform, nach Dauer. Dies ist eine Heuristik: 180 Sekunden oder weniger zählt als Short, da die API kein Shorts-Flag hat.
• Top 5 aktuelle Videos nach Aufrufen.
• Geschätzte monatliche Aufrufe: Summe der aktuellen Aufrufe von Videos, die in den letzten 30 Tagen veröffentlicht wurden. Dies lässt Aufrufe des hinteren Katalogs aus. Wenn die Stichprobe nicht 30 Tage zurückreicht, sagt der Bericht dies und fordert ein größeres --videos. Diese Prüfung geht davon aus, dass die Upload-Playlist die neuesten zuerst auflistet, wie üblich.

Die YouTube-API-Richtlinie III.E.4.h erlaubt abgeleitete Zahlen nur neben YouTubes eigenen Gesamtwerten, mit einem deutlichen Hinweis, dass sie nicht von YouTube stammen. Der Bericht tut beides. Behalten Sie diesen Hinweis bei, wann immer Sie eine mit Sternchen versehene Zahl zitieren.

Einnahmenmethode

niedrig = geschätzte monatliche Aufrufe / 1.000 x US$0,25
hoch   = geschätzte monatliche Aufrufe / 1.000 x US$4,00

US$0,25 bis US$4,00 ist Social Blades veröffentlichter Standard-CPM-Bereich (socialblade.com/youtube/calculator). Der Bericht gibt die Formel mit den tatsächlichen Zahlen aus. Es handelt sich ausschließlich um Werbeeinnahmen. Sponsoring, Mitgliedschaften, Shopping, Affiliate-Einnahmen und Fan-Finanzierungen werden ausgelassen. Der tatsächliche RPM variiert je nach Nische, Zielland und Format. Shorts-Einnahmen werden zu anderen Bedingungen zusammengefasst. Ein Kanal außerhalb des YouTube-Partnerprogramms erzielt keine Werbeeinnahmen. Bezeichnen Sie es immer als geschätzte Spanne, niemals als Einkommen.

Fehler

Exit	Bedeutung	Maßnahme
0	Bericht ausgegeben
2	Falsche Eingabe, fehlender Schlüssel oder kein Kanal gefunden	Korrigieren Sie die Eingabe oder bitten Sie den Benutzer um den Schlüssel oder den richtigen Link
3	Kontingent aufgebraucht	Stoppen. Teilen Sie dem Benutzer mit, dass es um Mitternacht Pazifischer Zeit zurückgesetzt wird. Wiederholen Sie nicht in einer Schleife oder wechseln Sie Schlüssel
4	Anderer API-Fehler, z. B. ungültiger Schlüssel oder API nicht aktiviert	Zeigen Sie dem Benutzer die Meldung
5	Netzwerkfehler	Einmal wiederholen, dann melden

Fehler geben das vor dem Fehler verbrauchte Kontingent aus. Jede Nachricht und jeder Bericht wird vom Schlüssel bereinigt, bevor er ausgegeben wird.

Regeln

• Nur offizielle API. Scrapen Sie keine YouTube-Seiten, um eine Lücke zu füllen. Melden Sie die Lücke.
• Nichts über den Lauf hinaus zwischenspeichern. Speichern Sie keine rohen API-Antworten. Wenn der Benutzer den Bericht aufbewahrt, dürfen API-Statistiken nicht länger als 30 Tage gespeichert werden (Richtlinie III.E.4.b).
• Nur öffentliche Daten. Demografische Daten des Publikums sind nicht öffentlich: siehe die creator-audience-Fähigkeit.

Geprüft am 5. November 2026 gegen die YouTube Data API-Referenz, die Kontingentseite, den Revisionsverlauf und die Entwicklerrichtlinien. Die Tests des Skripts laufen offline gegen Testdaten. Es wurde hier nicht gegen die Live-API ausgeführt.