twitch/
user-videos

Sammeln Sie eine Seite öffentlicher Twitch-Videos zu einem Benutzernamen, mit optionalen Filtern für Typ und Reihenfolge – mit Creator-Kontext, Medien, Dauer und sichtbarer Interaktion.

Twitch User Videos API

Kanalvideos
Typfilter
Sichtbare Interaktion
0,19 Credits pro Anfrage
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

Twitch User Videos

Videos eines Twitch-Kanals sind öffentliche Archive, Highlights und Uploads des Kanals mit Beschreibungen, Creator-Kontext, Medienverweisen, Dauer, Veröffentlichungszeitpunkt und sichtbarer Interaktion. Diese Datensätze unterstützen die Katalogisierung von Kanälen, den Vergleich von Formaten, die Recherche zum Veröffentlichungsverhalten und Leistungsberichte zu bestimmten Zeitpunkten.

Funktionen der Twitch User Videos API

  • Inventar pro BenutzernameLöst einen öffentlichen Twitch-Benutzernamen in die Videodatensätze auf, die für diesen Kanal in einer einzigen Quellanfrage zurückgegeben werden.
  • Filter für Archive, Highlights und UploadsWählen Sie alle Videos aus oder grenzen Sie die Quellanfrage mit den akzeptierten Werten archive, highlight oder upload und deren Pluralformen ein.
  • Sortierung nach Zeit oder AufrufenSortieren Sie die zurückgegebene Quellseite nach Zeit oder sichtbaren Aufrufen, um aktuelle Veröffentlichungen oder Videodatensätze mit mehr Aufrufen zu untersuchen.
  • Normalisierte VideodatensätzeLiefert Videoidentität, öffentliche URL, Beschreibung, Creator-Kontext, Medien, Dauer, Veröffentlichungszeitpunkt, Audio-Metadaten und sichtbare Interaktion in der Struktur ReelVideoItem.

Parameter der Twitch User Videos API

ParameterErforderlichBeschreibung
usernameErforderlichEin öffentlicher Twitch-Benutzername, optional mit führendem @, aus 1 bis 64 Buchstaben, Zahlen, Punkten, Unterstrichen oder Bindestrichen.
filter_byOptionalOptionaler Quelltyp: all, archive, archives, highlight, highlights, upload oder uploads. Die Formen im Singular und Plural werden derselben Kategorie des Anbieters zugeordnet.
sort_byOptionalOptionale Reihenfolge der Quelle: time oder views.

So verwenden Sie die Twitch User Videos API

Übergeben Sie einen Twitch-Benutzernamen mit optionalen Steuerungen für Videotyp und Sortierung und lesen Sie die eine Quellseite anschließend über den üblichen asynchronen Aufgabenablauf.

  1. Wählen Sie einen öffentlichen Twitch-Benutzernamen und entscheiden Sie, ob die Quellseite alle Videos oder einen akzeptierten Videotyp abdecken soll.
  2. Senden Sie username, filter_by und sort_by per POST an /v1/twitch/user-videos und speichern Sie die zurückgegebene Aufgaben-ID.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder fehlschlägt; senden Sie nicht erneut, sobald eine Aufgaben-ID existiert.
  4. Lesen Sie die ReelVideoItem-Datensätze aus results.items und nutzen Sie next_cursor nur, um durch gespeicherte Zeilen der Aufgabe zu blättern.
curl -X POST "https://api.socq.ai/v1/twitch/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja","filter_by":"all","sort_by":"time"}'

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

Anwendungsfälle der Twitch User Videos API

  • Katalogisierung von Kanalvideos: Bauen Sie mit Video-IDs, öffentlichen URLs, Beschreibungen, Medienverweisen, Dauer und Creator-Kontext ein aktuelles Inventar für einen bekannten Kanal auf.
  • Prüfung der Formatmischung: Führen Sie die akzeptierten Typfilter getrennt aus und vergleichen Sie Archive, Highlights und Uploads nach Veröffentlichungszeitpunkt und Dauer.
  • Momentaufnahmen zu Veröffentlichung und Aufrufen: Kombinieren Sie Veröffentlichungszeitstempel mit sichtbaren Aufruf- oder Wiedergabekennzahlen und collected_at, um eine Momentaufnahme eines Kanals festzuhalten.

Profi-Tipps zur Twitch User Videos API

  • Entfernen Sie bei der Angabe eines Benutzernamens Profil-URLs und behalten Sie nur das optionale @ und die akzeptierten 1 bis 64 Zeichen des Benutzernamens.
  • Verwenden Sie time, um aktuelle Veröffentlichungen zu prüfen, und views, um Datensätze mit mehr Aufrufen auf der zurückgegebenen Quellseite zu untersuchen.
  • Wählen Sie in gespeicherten Anfragedefinitionen einheitlich entweder die Singular- oder die Pluralformen der Typen, weil jedes Paar derselben Kategorie bei der Quelle entspricht.
  • Fügen Sie der Anfrage weder cursor noch results_limit hinzu; der Aufruf beim Anbieter liefert eine Seite, während der Cursor der Aufgabenergebnisse nur Zeilen durchblättert, die SocQ bereits gespeichert hat.
  • Entfernen Sie bei Langzeiterfassungen Duplikate anhand der Video-ID und rechnen Sie mit nullable Feldern für Text, Medien, Audio, Autor, Zeitstempel und Kennzahlen.

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

  • Twitch Profile API — Einen öffentlichen Twitch-Benutzernamen in einen normalisierten Kontodatensatz auflösen – mit verfügbarer Identität, Bio, Bildmaterial, Kontomerkmalen, sichtbaren Kennzahlen und Erfassungskontext.
  • Twitch Clip Downloader API — Einen öffentlichen Twitch-Clip über seine Clip-URL abrufen – mit Titel, Aufrufen, Länge, Erstellungszeit, Streamer-Profil und herunterladbarem MP4-Link samt Vorschaubild.

Weitere Plattformen entdecken

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

Twitch User Videos API — FAQ

Twitch User Videos API ist eine Schnittstelle zum Sammeln einer Seite öffentlicher Videodatensätze zu einem Twitch-Benutzernamen. Sie liefert normalisierte Videoidentität, Beschreibung, Creator-Kontext, Medien, Dauer, Veröffentlichungszeitpunkt, Audio-Metadaten und sichtbare Interaktion.

username ist erforderlich und akzeptiert ein optionales @, gefolgt von 1 bis 64 Buchstaben, Zahlen, Punkten, Unterstrichen oder Bindestrichen. filter_by akzeptiert all, archive, archives, highlight, highlights, upload oder uploads; sort_by akzeptiert time oder views.

Jedes ReelVideoItem kann eine ID, öffentliche URL, Beschreibung, Creator-Angaben, Medien, Hashtags, Erwähnungen, Dauer, Audio-Metadaten, Veröffentlichungszeitpunkt, Erfassungszeitpunkt und sichtbare Likes, Kommentare, Shares, Wiedergaben oder Aufrufe enthalten. Welche nullable Felder Werte enthalten, bestimmt die Verfügbarkeit bei der Quelle.

Nein. Die Spezifikation der Übergabe führt eine einzelne Quellanfrage aus und akzeptiert weder cursor noch results_limit. Nach Abschluss kann next_cursor durch die Ergebniszeilen blättern, die für diese Aufgabe bereits gespeichert sind, ruft aber keine weitere Quellseite ab.

Jede erfolgreiche Aufgabe kostet pauschal 0,19 Credits, unabhängig von der Anzahl der Datensätze auf der Quellseite.

Eine erfolgreiche Aufgabe kann ohne Elemente enden, wenn die öffentliche Quellseite für den gewählten Typ und die gewählte Reihenfolge keine passenden Datensätze hat oder wenn passende Videos nicht verfügbar sind. Behandeln Sie ein leeres Ergebnis getrennt von einer fehlgeschlagenen Aufgabe.