youtube/
channel-videos

Reguläre öffentliche Videos aus YouTube-Kanal-URLs sammeln – mit normalisierten Titeln, Vorschaubildern, Dauer, Angaben zur Veröffentlichung, Kanalkontext und Interaktionskennzahlen.

YouTube Channel Videos API

Kanal-Videos
Reguläre Uploads
Öffentliche Kennzahlen
0,5 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 Channel Videos

Kanal-Videos auf YouTube sind reguläre Uploads eines bestimmten Kanals mit Titeln, Beschreibungen, Vorschaubildern, Dauer, Angaben zur Veröffentlichung und sichtbarer Interaktion. Diese Datensätze unterstützen die Katalogisierung von Kanälen, Analysen des Veröffentlichungsverhaltens, die Beobachtung von Inhalten und historische Berichte.

Funktionen der YouTube Channel Videos API

  • Videosammlung über mehrere KanäleSammeln Sie reguläre öffentliche Videos aus mehreren Kanal-URLs in einer einzigen Anfrage.
  • Ergebnislimit pro KanalLegen Sie für jeden eingegebenen Kanal ein eigenes results_limit fest; der Standardwert ist 100.
  • Normalisierte VideometadatenLiefert normalisierte Video-Identität, Inhaltsmetadaten, Vorschaubilder, Dauer, Veröffentlichungsdatum und den veröffentlichenden Kanal.
  • Interaktionskennzahlen als MomentaufnahmeEnthält die öffentlichen Zahlen zu Aufrufen, „Gefällt mir“-Angaben und Kommentaren samt collected_at für spätere Vergleiche.
  • Beschränkung auf reguläre VideosSchließt Shorts und Livestreams aus, damit das Ergebnis auf reguläre Kanalvideos konzentriert bleibt.

Parameter der YouTube Channel Videos API

ParameterErforderlichBeschreibung
urlsErforderlichÖffentliche YouTube-Kanal-URLs, getrennt durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximale Anzahl infrage kommender Datensätze, die für jede eingegebene URL angefordert werden. Muss eine positive ganze Zahl sein; der Standardwert ist 100.

So verwenden Sie die YouTube Channel Videos API

Legen Sie fest, wie tief jeder Kanal untersucht werden soll, und sammeln Sie ein sauberes Inventar regulärer Videos. Ein Batch kann mehrere Kanäle enthalten, das angeforderte Limit gilt aber für jeden einzelnen.

  1. Bereiten Sie öffentliche Kanal-URLs vor und entscheiden Sie, ob Sie eine aktuelle Stichprobe oder einen tieferen Rückblick benötigen.
  2. Senden Sie urls und results_limit per POST an /v1/youtube/channel-videos; beachten Sie, dass das Limit pro Kanal gilt.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Inventaraufgabe succeeded oder failed erreicht.
  4. Gruppieren Sie die zurückgegebenen Elemente nach Kanal-ID, entfernen Sie Duplikate anhand der Video-ID und paginieren Sie, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/channel-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Anwendungsfälle der YouTube Channel Videos API

  • Content-Feeds für Kanäle: Bauen Sie einen strukturierten Feed regulärer öffentlicher Videos aus ausgewählten Kanälen auf.
  • Analyse von Veröffentlichung und Performance: Vergleichen Sie Veröffentlichungsfrequenz, Dauer, Themen und öffentliche Interaktion über Kanäle hinweg.
  • Beobachtung von Creators und Wettbewerbern: Verfolgen Sie die Aktivität bei regulären Videos von Creators, Verlagen, Marken oder Wettbewerbern.
  • Aufbau eines Videokatalogs: Versorgen Sie Workflows für Klassifizierung, Zusammenfassung, Suche oder Berichte, ohne jede Video-URL manuell zu erfassen.

Profi-Tipps zur YouTube Channel Videos API

  • Das Limit multipliziert sich über alle Eingaben. Zehn Kanäle mit results_limit 100 fordern bis zu 1.000 Datensätze regulärer Videos an.
  • Beginnen Sie bei einer neuen Kanalliste mit einem flachen Limit, prüfen Sie die Eignung der Kanäle und erhöhen Sie das Limit nur dort, wo ein tieferer Verlauf nützlich ist.
  • Weniger Ergebnisse können bedeuten, dass der Kanal weniger infrage kommende öffentliche Uploads hat. Das weist nicht automatisch auf eine fehlgeschlagene Aufgabe hin.
  • Stellen Sie die Antwort nicht als garantiert vollständiges Archiv dar; Verfügbarkeit und öffentlicher Kanalbestand können sich ändern.
  • Nutzen Sie die Video-ID zur Deduplizierung und speichern Sie für Längsschnittanalysen sowohl die Kanal-ID der Quelle als auch collected_at.
  • Rufen Sie Shorts gesondert ab, wenn die Mischung der Formate wichtig ist. Wenn Sie beide erst nach der Erfassung zusammenführen, bleibt die Klassifizierung eindeutig.
  • Nutzen Sie Channels für aktuelle Profilfelder, statt Kanalbiografien und Zähler in jede Upload-Zeile zu kopieren.

Ergänzend zur YouTube Channel Videos API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher YouTube-Daten benötigen.

  • YouTube Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Quellvideos und Gesprächskontext erfassen.
  • YouTube Transcripts API — Verfügbare Klartext-Transkripte mit optionaler Sprachauswahl abrufen.
  • YouTube Channels API — Öffentliche Kanalidentität, Bilder, Verifizierung und sichtbare Statistiken zur Zielgruppe abrufen.
  • YouTube Videos API — Metadaten, Thumbnails, Dauer und Interaktionen zu bekannten Video- oder Short-URLs abrufen.
  • YouTube Shorts API — Öffentliche Shorts, Thumbnails, Dauer, Veröffentlichungsdetails und Interaktionen pro Kanal erfassen.
  • YouTube Channel Live Videos API — Öffentliche Übertragungen erfassen, die in den Live-Bereichen eines Kanals angezeigt werden – mit Quellkontext und sichtbaren Kennzahlen.

Weitere Plattformen entdecken

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

YouTube Channel Videos API — FAQ

YouTube Channel Videos API sammelt reguläre öffentliche Videos aus einer oder mehreren YouTube-Kanal-URLs. Die Schnittstelle liefert normalisierte Titel, Beschreibungen, Kanalinformationen, Vorschaubilder, Dauer, Veröffentlichungsdaten, Interaktionskennzahlen und den Zeitpunkt der Erfassung.

Senden Sie eine oder mehrere öffentliche YouTube-Kanal-URLs und optional ein results_limit.

results_limit hat den Standardwert 100 und gilt separat für jede Kanal-URL. Die Gesamtzahl kann niedriger ausfallen, wenn ein Kanal weniger infrage kommende öffentliche reguläre Videos hat.

Nein. Dieser Endpunkt liefert reguläre Kanalvideos. Für Shorts eines Kanals nutzen Sie Shorts.

Nein. Aufrufe, „Gefällt mir“-Angaben und Kommentare sind öffentliche Werte zum Zeitpunkt der Erfassung. Für historische Vergleiche sind wiederholte Abrufe nötig.

Die Nutzung kostet 0,5 Credits für jedes zurückgegebene normalisierte Videoergebnis.