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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
username | Erforderlich | Ein öffentlicher Twitch-Benutzername, optional mit führendem @, aus 1 bis 64 Buchstaben, Zahlen, Punkten, Unterstrichen oder Bindestrichen. |
filter_by | Optional | Optionaler Quelltyp: all, archive, archives, highlight, highlights, upload oder uploads. Die Formen im Singular und Plural werden derselben Kategorie des Anbieters zugeordnet. |
sort_by | Optional | Optionale 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.
- Wählen Sie einen öffentlichen Twitch-Benutzernamen und entscheiden Sie, ob die Quellseite alle Videos oder einen akzeptierten Videotyp abdecken soll.
- Senden Sie username, filter_by und sort_by per POST an /v1/twitch/user-videos und speichern Sie die zurückgegebene Aufgaben-ID.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder fehlschlägt; senden Sie nicht erneut, sobald eine Aufgaben-ID existiert.
- 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=50Anwendungsfä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.
Verwandte APIs
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.