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.
| Funktion | SocQ | Twitch API |
|---|---|---|
| Hauptzweck | Ein öffentliches Profil auflösen, eine Seite mit Nutzer-Videos erfassen oder einen Clip laden | Native Twitch-Integrationen rund um Twitch-Ressourcen aufbauen |
| Authentifizierung | SocQ-API-Schlüssel | Twitch-Anwendung und die jeweilige Nutzer- oder Anwendungsautorisierung |
| Ausgangseingabe | Ein Benutzername, bei Clips eine Clip-URL | Native Anfrageparameter und Twitch-Ressourcenkennungen |
| Kanalverwaltung | Nicht unterstützt | Autorisierte Twitch-APIs und die erforderlichen Berechtigungen verwenden |
| Antwortformat | Normalisierte SocQ-Datensätze vom Typ AccountItem oder ReelVideoItem | Native Twitch-Antwortobjekte |
So funktioniert die Twitch API
Alle Twitch-APIs nutzen den gemeinsamen asynchronen SocQ-Aufgabenablauf mit gespeicherten Ergebnissen.
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. Aufgabe verfolgen
Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder fehlschlägt.
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.
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.itemsTypische 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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.
Rednote API
Rufen Sie öffentliche Profile und Notes ab, suchen Sie nach Notes oder Nutzern, erfassen Sie Kommentare und verschachtelte Antworten und holen Sie eine Seite mit Empfehlungen der Startseite.
Kwai API
Rufen Sie öffentliche Kwai-Profile, eine Seite mit Kontobeiträgen oder einen bekannten Beitrag ab – mit normalisierten Angaben zu Identität, Inhalt, Medien, Zeitstempeln und sichtbarem Engagement.
Truth Social API
Rufen Sie öffentliche Kontodetails ab, erfassen Sie eine Quellseite mit Kontobeiträgen oder wandeln Sie die URL eines bekannten Beitrags in normalisierte Datensätze um.
Google Ad Library API
Finden Sie öffentliche Werbetreibende, erfassen Sie die Creatives eines Unternehmens oder rufen Sie ein bekanntes Creative aus dem Transparency Center per URL ab – für Recherche und Prüfung.
Google Maps API
Finden Sie öffentliche Orte, rufen Sie normalisierte Details zu bekannten Maps-URLs ab und erfassen Sie öffentliche Bewertungen mit quellenverknüpftem Orts- und Autorenkontext.
Amazon API
Durchsuchen Sie öffentliche Amazon-Produkte und erfassen Sie normalisierte Produktdetails, Bestseller, Bewertungen, Verkäuferprofil-Datensätze und Creator-Storefronts aus unterstützten Marktplätzen.


