YouTube Channels
YouTube-Kanäle sind öffentliche Seiten von Creators, Marken oder Organisationen mit Identität, Beschreibungen, Bildern, Verifizierung, Profil-Links und den sichtbaren Gesamtzahlen zu Abonnenten, Videos und Aufrufen. Diese Kanalsignale unterstützen die Creator-Recherche, den Vergleich von Zielgruppen, die Anreicherung von Verzeichnissen und die Marktanalyse.
Funktionen der YouTube Channels API
- Profilsammlung über mehrere KanäleSammeln Sie öffentliche Profile zu mehreren Kanal-URLs in einer einzigen Anfrage.
- Normalisierte KanalidentitätLiefert Kanal-ID, Handle, Anzeigename, kanonische URL, Beschreibung, Avatar und Banner in einer einheitlichen Struktur.
- Öffentliche KanalkennzahlenEnthält Verifizierungsstatus, öffentliche Abonnentenzahl, Anzahl veröffentlichter Videos und die gesamten Aufrufe des Kanals.
- Felder mit ProfilkontextBehält den öffentlichen Standort, Profil-Links, das Erstellungsdatum des Kanals und die übergebene Kanal-URL bei.
- Zeitstempel der ErfassungErgänzt jedes Ergebnis um collected_at, damit gespeicherte Datensätze über verschiedene Erfassungsdaten hinweg verglichen werden können.
Parameter der YouTube Channels API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Öffentliche YouTube-Kanal-URLs, getrennt durch Kommas oder Zeilenumbrüche. |
So verwenden Sie die YouTube Channels API
Machen Sie aus einer Liste öffentlicher Kanalseiten dauerhafte Identitätsdatensätze. Die Anfrage ist asynchron, bewahren Sie die Aufgaben-ID daher auf, bis jeder übergebene Kanal aufgelöst wurde.
- Erstellen Sie eine deduplizierte Liste öffentlicher Kanal- oder @Handle-URLs, keine Video-Wiedergabe-URLs.
- Senden Sie das Array urls per POST an /v1/youtube/channels und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab; queued und running sind normale Zwischenzustände.
- Indizieren Sie nach einem erfolgreichen Abschluss data.results.items nach id und fahren Sie mit next_cursor fort, wenn has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@NASA"]}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Anwendungsfälle der YouTube Channels API
- Verzeichnisse für Creators und Marken: Reichern Sie ein Verzeichnis mit stabilen Kanal-IDs, Profildetails, Bildern, Links und öffentlichen Reichweitenkennzahlen an.
- Qualifizierung von Creators: Prüfen Sie Kanalbeschreibungen, Verifizierung, öffentliche Reichweite, Veröffentlichungsaktivität und Profil-Links, wenn Sie mögliche Partner bewerten.
- Kanalvergleich: Vergleichen Sie die öffentlichen Zahlen zu Abonnenten, Videos und Aufrufen über Creators, Marken, Publikationen oder Wettbewerber hinweg.
- Profilbeobachtung: Erfassen Sie dieselben Kanäle über einen längeren Zeitraum, um Änderungen bei öffentlichen Profildetails und Reichweitenstatistiken zu verfolgen.
Profi-Tipps zur YouTube Channels API
- Speichern Sie id als Primärschlüssel. Ein Handle eignet sich für Anzeige und Routing, kann sich aber ändern, ohne dass ein neuer Kanal entsteht.
- Wandeln Sie eine ausgeblendete Abonnentenzahl nicht in 0 um. Null bedeutet, dass der Wert nicht öffentlich verfügbar war, und das ist ein anderes Geschäftssignal.
- Behandeln Sie Links aus der Beschreibung als nicht vertrauenswürdige externe URLs. Prüfen und bereinigen Sie sie, bevor Sie sie in einem internen Tool anzeigen.
- Vergleichen Sie Reichweitenzähler nur, wenn collected_at vorhanden ist, und verwenden Sie für Trendberechnungen einen einheitlichen Erfassungsrhythmus.
- Ein erfolgreicher Batch kann trotzdem weniger Datensätze als URLs enthalten, wenn ein Kanal gelöscht, eingeschränkt oder nicht mehr öffentlich ist.
- Verknüpfen Sie Channels über die Kanal-ID mit Channel Videos oder Shorts, statt Profilfelder in jeder Inhaltszeile zu wiederholen.
Verwandte APIs
Ergänzend zur YouTube Channels API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher YouTube-Daten benötigen.
- YouTube Channel Videos API — Reguläre öffentliche Videos aus Kanal-URLs erfassen – ohne Shorts und Livestreams.
- YouTube Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Quellvideos und Gesprächskontext erfassen.
- YouTube Transcripts API — Verfügbare Klartext-Transkripte mit optionaler Sprachauswahl abrufen.
- YouTube Shorts API — Öffentliche Shorts, Thumbnails, Dauer, Veröffentlichungsdetails und Interaktionen pro Kanal erfassen.
- YouTube Community Posts API — Öffentliche Beiträge aus dem Community-Tab per Kanal-URL erfassen, einschließlich Text, Kanalidentität, Zeitstempeln, Bildverweisen und Quellkontext.
- YouTube Email Finder API — Öffentliche geschäftliche E-Mail-Adressen zu einer Kanal-URL finden – mit den Seiten, auf denen jede Adresse erscheint.
- YouTube Videos API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Trending Videos API