youtube/
channel-live-videos

Öffentliche Übertragungen aus den Live-Bereichen von YouTube-Kanälen erfassen – mit normalisierten Video-Metadaten, Kanalkontext, Vorschaubildern, Angaben zur Veröffentlichung und sichtbarer Interaktion.

YouTube Channel Live Videos API

Live-Bereich des Kanals
Öffentliche Übertragungen
Asynchrone Erfassung
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 Live Videos

YouTube Channel Live Videos sind öffentliche Übertragungseinträge, die im Live-Bereich eines bestimmten Kanals angezeigt werden, mit Video-Identität, Kanalkontext, Vorschaubildern, Zeitstempeln und sichtbarer Interaktion. Je nachdem, was YouTube für diesen Kanal bereitstellt, kann die Erfassung laufende, bevorstehende oder archivierte Übertragungen enthalten, ohne dass ein normalisiertes Live-Status-Label garantiert wird.

Funktionen der YouTube Channel Live Videos API

  • Unterstützung kanonischer Kanal-URLsLöst öffentliche YouTube-URLs der Form /@handle, /channel/{id}, /c/{name} und /user/{name} auf.
  • Entdeckung im Live-Bereich des KanalsErfasst die Übertragungseinträge, die im Live-Bereich jedes übergebenen Kanals bereitgestellt werden.
  • Erfassungstiefe pro KanalFordern Sie für jeden Eingabekanal 20 bis 2.000 Datensätze an; standardmäßig gelten 100.
  • Normalisierte ÜbertragungsdatensätzeLiefert Video-Identität, Titel, Beschreibung, Kanal, Vorschaubild, Dauer, Hashtags, Veröffentlichungszeit und Quellkontext, sofern verfügbar.
  • Momentaufnahmen der sichtbaren InteraktionErfasst die öffentlichen Zahlen zu Aufrufen, Likes und Kommentaren zusammen mit collected_at für Analysen zu einem bestimmten Zeitpunkt.
  • Asynchrone Bereitstellung der ErgebnisseFragen Sie den Aufgabenstatus ab, behalten Sie die Aufgaben-ID und nutzen Sie die Cursor-Paginierung für eine zuverlässige asynchrone Bereitstellung der Ergebnisse.

Parameter der YouTube Channel Live Videos API

ParameterErforderlichBeschreibung
urlsErforderlichÖffentliche YouTube-Kanal-URLs, getrennt durch Kommas oder Zeilenumbrüche. Unterstützte Pfade sind /@handle, /channel/{id}, /c/{name} und /user/{name}.
results_limitOptionalMaximale Anzahl Datensätze, die für jede Kanal-URL angefordert werden. Muss eine ganze Zahl von 20 bis 2.000 sein; Standard ist 100.

So verwenden Sie die YouTube Channel Live Videos API

Senden Sie kanonische öffentliche Kanal-URLs und wählen Sie für jede eine Erfassungstiefe. Die Anfrage erzeugt eine asynchrone Aufgabe, daher sind Abschluss und Abruf der Ergebnisse getrennte Schritte.

  1. Bereiten Sie eine oder mehrere öffentliche YouTube-Kanal-URLs mit einem unterstützten Pfad für Handle, Kanal-ID, benutzerdefinierten Namen oder Benutzer vor.
  2. Senden Sie urls und results_limit per POST an /v1/youtube/channel-live-videos und behalten Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
  4. Lesen Sie die Ergebnisseiten über /v1/tasks/{task_id}?limit=50 und geben Sie next_cursor als cursor zurück, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/channel-live-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'

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

Anwendungsfälle der YouTube Channel Live Videos API

  • Aufbau eines Übertragungsinventars: Erstellen Sie eine strukturierte Liste öffentlicher Übertragungen, die zu ausgewählten Kanälen gehören.
  • Recherche zum Livestream-Programm: Vergleichen Sie Titel, Zeitpunkte, Dauer und Veröffentlichungsmuster über Kanäle mit wiederkehrendem Live-Programm hinweg.
  • Monitoring von Creator-Übertragungen: Verfolgen Sie, welche öffentlichen Übertragungsdatensätze in den Live-Bereichen von Creator-, Marken-, Verlags- oder Wettbewerberkanälen sichtbar sind.
  • Momentaufnahmen der Leistung nach der Übertragung: Speichern Sie sichtbare Aufrufe, Likes und Kommentare mit dem Erfassungszeitpunkt für spätere Trendvergleiche.
  • Anreicherung eines öffentlichen Mediankatalogs: Ergänzen Sie Such-, Reporting- oder Klassifizierungssysteme um normalisierte Übertragungs-Metadaten und den Kontext des Quellkanals.

Profi-Tipps zur YouTube Channel Live Videos API

  • results_limit gilt für jeden Kanal. Fünf URLs mit einem Limit von 100 fordern bis zu 500 Datensätze an, bevor die aufgabenweite Deduplizierung greift.
  • Verwenden Sie kanonische Kanal-URLs mit einem nicht leeren Handle, einer Kanal-ID, einem benutzerdefinierten Namen oder einem Benutzernamen; ein bloßer Pfad /channel kann keine Quelle auflösen.
  • Betrachten Sie den Live-Bereich des Kanals als Grenze der Eignung. Die Verfügbarkeit laufender, bevorstehender und archivierter Übertragungen kann sich zwischen Erfassungen ändern.
  • Leiten Sie aus type oder extra.content_type keinen verlässlichen Zustand laufend, bevorstehend oder archiviert ab; die normalisierte Nutzlast hat kein eigenes Feld für den Live-Status.
  • Die Antwort enthält Metadaten und Verweise auf Vorschaubilder, aber keinen Live-Chat, keine abspielbare Stream-URL, keine Untertitel und keinen Transkripttext.
  • Gleichwertige Kanaleingaben können dasselbe Video finden. Gespeicherte Aufgabenergebnisse werden anhand der normalisierten Video-ID dedupliziert, ohne ID anhand der URL.
  • Das Ergebnislimit der Aufgabe ist von results_limit getrennt: Fordern Sie 1 bis 500 gespeicherte Zeilen pro Seite an und verwenden Sie den undurchsichtigen next_cursor weiter, bis has_more false ist.
  • Öffentliche Metadaten schalten kein privates Ansehen oder Ansehen nur für Mitglieder frei. Behalten Sie extra.is_members_only bei, wenn die Quelle diese Einstufung meldet.

Ergänzend zur YouTube Channel Live Videos 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 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.

Weitere Plattformen entdecken

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

YouTube Channel Live Videos API — FAQ

YouTube Channel Live Videos API erfasst normalisierte öffentliche Übertragungsdatensätze, die im Live-Bereich eines oder mehrerer YouTube-Kanäle bereitgestellt werden. Sie liefert Video- und Kanalidentität, beschreibende Metadaten, Vorschaubilder, Zeitstempel, sichtbare Interaktion, Eingabekontext und Erfassungszeitpunkt, sofern verfügbar.

Verwenden Sie eine öffentliche youtube.com-URL mit /@handle, /channel/{id}, /c/{name} oder /user/{name}. Das Segment mit der Kennung darf nicht leer sein.

Nein. Der berücksichtigte Kanalbereich kann laufende, bevorstehende oder archivierte Übertragungen anzeigen, und die Verfügbarkeit kann je nach Kanal und Erfassungszeitpunkt variieren.

Nein. extra.content_type kann eine Einstufung der Quelle bewahren, sofern vorhanden, ersetzt aber nicht verlässlich einen eigenen Status laufend, bevorstehend oder archiviert.

results_limit ist standardmäßig 100, akzeptiert 20 bis 2.000 und gilt getrennt für jede übergebene Kanal-URL. Die tatsächlich gespeicherten Zeilen können wegen der Verfügbarkeit des Kanals und der aufgabenweiten Deduplizierung von Videos niedriger sein.

Nein. Der Endpunkt liefert öffentliche Übertragungs-Metadaten und Verweise auf Vorschaubilder; Live-Chat-Nachrichten, abspielbare Stream-Dateien, Untertitel oder Transkripte liefert er nicht.

Die Anfrage wird aus der Anzahl der Kanal-URLs multipliziert mit results_limit geschätzt und anschließend mit 0,5 Credits für jedes gespeicherte normalisierte Ergebnis abgeglichen. Für ein leeres Ergebnis fällt keine Ergebnisgebühr an, weil die konfigurierte Grundgebühr null ist.