youtube/
channels

Öffentliche YouTube-Kanalprofile aus Kanal-URLs abrufen – mit normalisierter Identität, Beschreibungen, Bildern, Verifizierung und sichtbaren Reichweitenstatistiken.

YouTube Channels API

Kanäle
Öffentliche Profile
Sichtbare Kennzahlen
0,26 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
urlsErforderlichÖ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.

  1. Erstellen Sie eine deduplizierte Liste öffentlicher Kanal- oder @Handle-URLs, keine Video-Wiedergabe-URLs.
  2. Senden Sie das Array urls per POST an /v1/youtube/channels und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab; queued und running sind normale Zwischenzustände.
  4. 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=50

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie YouTube-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

YouTube Channels API — FAQ

YouTube Channels API ruft öffentlich sichtbare Profildaten aus einer oder mehreren YouTube-Kanal-URLs ab. Die Schnittstelle liefert normalisierte Identität, Beschreibungen, Bilder, Verifizierung, Reichweitenstatistiken, Standort, Profil-Links und den Zeitpunkt der Erfassung.

Senden Sie eine oder mehrere öffentliche YouTube-Kanal-URLs im Array urls. Jeder zugängliche Kanal wird als eigenes normalisiertes Ergebnis zurückgegeben.

Ja. Fügen Sie dem Array urls mehrere öffentliche Kanal-URLs hinzu, um deren Profildatensätze gemeinsam zu sammeln.

Ein Kanal kann seine Abonnentenzahl ausblenden, und optionale öffentliche Profilfelder sind nicht bei jedem Kanal vorhanden. Fehlende öffentliche Werte bleiben leer und werden nicht als null ausgegeben.

Nein. Dieser Endpunkt liefert Kanalprofildaten und aggregierte Statistiken. Für reguläre Uploads nutzen Sie Channel Videos, für Shorts eines Kanals Shorts.

Die Nutzung kostet 0,26 Credits für jedes zurückgegebene normalisierte Kanalergebnis.