Zurück zu den APIs
Öffentliche Twitch-Daten

Twitch Public Data API

Wandeln Sie einen bekannten öffentlichen Twitch-Benutzernamen in ein normalisiertes Profil um, erfassen Sie dessen öffentlichen Videobestand oder laden Sie einen einzelnen Clip samt herunterladbarem Video für Creator-Recherche, Kataloganreicherung, Vergleiche und die Beobachtung per Momentaufnahme.

Verfügbare Twitch-APIs

Verwenden Sie Twitch Profile API für die normalisierte Kontoidentität, Twitch User Videos API für eine öffentliche Videoseite mit unterstützten Typ- und Sortierfiltern oder Twitch Clip Downloader API für einen öffentlichen Clip über seine Clip-URL.

Welche Twitch-Daten können Sie abrufen?

Der Twitch-Katalog liefert zu einem Benutzernamen einen normalisierten öffentlichen Kontodatensatz oder eine Seite mit normalisierten öffentlichen Videos und zu einer Clip-URL einen öffentlichen Clip; Felder bleiben leer (null), wenn die Quelle keinen Wert bereitstellt.

Profilidentität

Rufen Sie verfügbare Angaben zu Konto-ID, öffentlicher URL, Benutzername, Anzeigename und Bio ab.

Profildarstellung

Behalten Sie verfügbare Felder zu Avatar, Titelbild und zugehöriger Website bei.

Kontosignale

Lesen Sie die Kennzeichen für verifiziert und privat, die null sein können, ohne fehlende Werte abzuleiten.

Sichtbare Kontozahlen

Behalten Sie die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen zusammen mit collected_at für Vergleiche von Momentaufnahmen bei.

Öffentliche Nutzer-Videos

Erfassen Sie aus einer Quellseite Videoidentität, Creator-Kontext, Medien, Dauer, Veröffentlichungszeitpunkt und sichtbare Interaktion.

Öffentliche Clips

Rufen Sie Titel, Aufrufe, Länge, Erstellungszeit und Streamer eines Clips sowie einen herunterladbaren MP4-Link mit Vorschaubild ab.

SocQ vs Twitch API

SocQ liefert öffentliche Profile, Nutzer-Videos und Clips in normalisierten Aufgabenabläufen; die nativen Twitch-APIs und deren Authentifizierung eignen sich für autorisierte Anwendungsintegrationen und Kanalfunktionen.

FunktionSocQTwitch API
HauptzweckEin öffentliches Profil auflösen, eine Seite mit Nutzer-Videos erfassen oder einen Clip ladenNative Twitch-Integrationen rund um Twitch-Ressourcen aufbauen
AuthentifizierungSocQ-API-SchlüsselTwitch-Anwendung und die jeweilige Nutzer- oder Anwendungsautorisierung
AusgangseingabeEin Benutzername, bei Clips eine Clip-URLNative Anfrageparameter und Twitch-Ressourcenkennungen
KanalverwaltungNicht unterstütztAutorisierte Twitch-APIs und die erforderlichen Berechtigungen verwenden
AntwortformatNormalisierte SocQ-Datensätze vom Typ AccountItem oder ReelVideoItemNative Twitch-Antwortobjekte

So funktioniert die Twitch API

Alle Twitch-APIs nutzen den gemeinsamen asynchronen SocQ-Aufgabenablauf mit gespeicherten Ergebnissen.

  1. 1. Endpunkt wählen

    Senden Sie einen gültigen öffentlichen Benutzernamen per POST an /v1/twitch/profile oder /v1/twitch/user-videos oder eine Clip-URL an /v1/twitch/clip und speichern Sie task_id.

  2. 2. Aufgabe verfolgen

    Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder fehlschlägt.

  3. 3. Gespeicherte Datensätze lesen

    Nutzen Sie data.results.items für die Profil- oder Videodatensätze und bewahren Sie den Kontext des Erfassungszeitpunkts auf.

Ein öffentliches Twitch-Profil auflösen

Authentifizieren Sie sich mit einem SocQ-API-Schlüssel und senden Sie genau einen unterstützten Benutzernamen. Die erfolgreiche Aufgabe kostet pauschal 0,19 Credits.

curl -X POST "https://api.socq.ai/v1/twitch/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja"}'

# Poll GET /v1/tasks/{task_id}
# Read the normalized account in data.results.items

Typische Anwendungsfälle der Twitch API

Anreicherung der Creator-Identität

Ergänzen Sie bekannte Creator-Datensätze um verfügbare Twitch-Angaben zu Identität, Bio, Bildern, Website, Kontomerkmalen und öffentlichen Zahlen.

Auflösung von Benutzernamen

Lösen Sie einen übermittelten Benutzernamen auf, bevor Sie das öffentliche Profil einer internen Recherche-Entität zuordnen.

Kontovergleich

Vergleichen Sie getrennt erfasste Profile anhand derselben Identitäts- und Kennzahlenfelder, die null sein können.

Beobachtung per Momentaufnahme

Behalten Sie collected_at zusammen mit den öffentlichen Profilwerten bei, damit sich spätere Durchläufe als eigene Momentaufnahmen unterscheiden lassen.

Anreicherung des Videobestands

Ergänzen Sie bekannte Kanäle um öffentliche Videoidentität, Medien, Creator-Kontext, Dauer, Zeitstempel und sichtbare Interaktion.

Archivierung von Highlights

Speichern Sie die MP4 eines Clips mit Titel, Streamer und Erstellungszeit, um eine durchsuchbare Sammlung der besten Momente eines Kanals aufzubauen.

Grenzen und Richtlinie für öffentliche Daten

Die Twitch-Endpunkte sind schreibgeschützte Abfragen öffentlicher Profile, Nutzer-Videos und Clips. Sie bieten weder authentifizierte Kanalaktionen noch Daten zu Mitgliedern des Publikums.

  • Profile und User Videos akzeptieren nur einen Benutzernamen; eine Kanal-URL, eine Liste von Benutzernamen oder results_limit werden nicht akzeptiert.
  • Twitch Clip Downloader akzeptiert eine Clip-URL im Format twitch.tv/<channel>/clip/<slug> oder clips.twitch.tv/<slug>; der gelieferte MP4-Link ist signiert und läuft nach etwa einem Tag ab.
  • Der Benutzername darf mit einem @ beginnen und muss ansonsten aus 1 bis 64 ASCII-Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen bestehen.
  • Die Profilabfrage liefert höchstens ein Profilobjekt der Quelle; User Videos erfasst eine Quellseite und akzeptiert weder einen vom Aufrufer gesteuerten Cursor noch results_limit.
  • Profilidentität, Bilder, Website, Kennzeichen, Standort und einzelne Kennzahlen können null sein, wenn die öffentlichen Quelldaten nicht verfügbar sind.
  • Der Endpunkt meldet sich nicht an, veröffentlicht nichts, moderiert nicht, verwaltet keinen Kanal, ruft keine privaten Analysen ab und führt keine per OAuth autorisierten Kontoaktionen aus.

Häufige Fragen zur Twitch API

Was ist die Twitch API?

Die Twitch-APIs lösen über asynchrone Aufgaben einen bekannten öffentlichen Benutzernamen in ein normalisiertes Profil auf, erfassen eine Seite seiner öffentlichen Videos oder laden einen öffentlichen Clip über seine URL.

Welche Twitch-APIs sind derzeit verfügbar?

Derzeit sind Twitch Profile API, Twitch User Videos API und Twitch Clip Downloader API verfügbar.

Kann ich eine Twitch-URL senden?

Twitch Clip Downloader API nimmt eine Clip-URL in url an. Twitch Profile und User Videos verlangen username und lehnen url, urls und andere nicht deklarierte Felder ab.

Verwaltet diese API einen Twitch-Kanal?

Nein. Alle Twitch-Endpunkte sind schreibgeschützte Abfragen öffentlicher Daten; sie authentifizieren keinen Twitch-Nutzer, veröffentlichen nichts, moderieren nicht, verwalten keine Kanaleinstellungen und rufen keine privaten Analysen ab.

Warum können Felder null sein?

Normalisierte Konto- und Videodatensätze behalten optionale öffentliche Felder als null bei, wenn die Quelle oder der Anbieter zum Zeitpunkt der Erfassung keinen Wert bereitstellt.

Wie werden Twitch-Anfragen abgerechnet?

Jede erfolgreiche Aufgabe von Twitch Profile oder User Videos kostet pauschal 0,19 SocQ-Credits. Jede Anfrage an Twitch Clip Downloader kostet 0,5 Credits; wird der Clip nicht gefunden, wird sie vollständig erstattet.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.