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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Öffentliche YouTube-Kanal-URLs, getrennt durch Kommas oder Zeilenumbrüche. Unterstützte Pfade sind /@handle, /channel/{id}, /c/{name} und /user/{name}. |
results_limit | Optional | Maximale 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.
- Bereiten Sie eine oder mehrere öffentliche YouTube-Kanal-URLs mit einem unterstützten Pfad für Handle, Kanal-ID, benutzerdefinierten Namen oder Benutzer vor.
- Senden Sie urls und results_limit per POST an /v1/youtube/channel-live-videos und behalten Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
- 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.
Verwandte APIs
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.
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts 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 Email Finder API
- YouTube Trending Videos API