Twitch Profile
Ein öffentliches Twitch-Profil kann Benutzernamen, Anzeigenamen, Biografie, Profilbilder, Website, Verifizierungs- oder Datenschutzsignale, Standortkontext und sichtbare Kontozahlen offenlegen. Der normalisierte Kontodatensatz unterstützt Creator-Anreicherung, Profilprüfungen und wiederholbare Momentaufnahmen öffentlicher Daten, bietet aber weder Kanalverwaltung noch Aktionen mit angemeldetem Konto.
Funktionen der Twitch Profile API
- Exakte Abfrage per BenutzernameÜbergeben Sie einen erforderlichen Benutzernamen aus 1 bis 64 unterstützten Zeichen, optional mit einem einzelnen führenden @.
- Normalisierte öffentliche IdentitätLesen Sie die verfügbare Profil-ID, öffentliche URL, Benutzername, Anzeigename, Biografie, Avatar, Titelbild und Website in der Spezifikation AccountItem aus.
- Signale zum KontozustandBehält die verfügbaren Merkmale für verifiziert und privat als nullable Felder bei, statt Werte abzuleiten, wenn der Anbieter sie nicht bereitstellt.
- Sichtbare ProfilkennzahlenNutzen Sie die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen als getrennte optionale Kennzahlen, die an den Erfassungszeitpunkt gebunden sind.
- Asynchroner AufgabenablaufÜbergeben Sie den Benutzernamen, behalten Sie die task_id, fragen Sie den gemeinsamen Aufgabenleser ab und rufen Sie nach dem Erfolg das gespeicherte normalisierte Ergebnis ab.
- Feste Abrechnung pro AnfrageEine erfolgreiche Aufgabe kostet pauschal 0,19 SocQ-Credits, unabhängig davon, welche optionalen Felder verfügbar sind.
Parameter der Twitch Profile API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
username | Erforderlich | Erforderlicher Twitch-Benutzername. Nach dem Zuschneiden darf er mit einem @ beginnen und muss dann 1 bis 64 ASCII-Buchstaben, Zahlen, Punkte, Unterstriche oder Bindestriche enthalten. |
So verwenden Sie die Twitch Profile API
Übergeben Sie einen unterstützten Twitch-Benutzernamen, verfolgen Sie die asynchrone Aufgabe und lesen Sie das einzelne gespeicherte Profilergebnis über die gemeinsame Cursor-Antwort.
- Wählen Sie einen öffentlichen Twitch-Benutzernamen, der der unterstützten Zeichenregel entspricht.
- Senden Sie username per POST an /v1/twitch/profile und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- Lesen Sie data.results.items; die Profilabfrage erzeugt höchstens einen Quelldatensatz, während die Hülle des gespeicherten Ergebnisses dennoch has_more und next_cursor enthält.
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.itemsAnwendungsfälle der Twitch Profile API
- Anreicherung von Creator-Datensätzen: Ergänzen Sie einen bekannten Creator-Datensatz um die verfügbare Twitch-Identität, Biografie, Bildmaterial, Website, Kontomerkmale und öffentliche Zahlen.
- Workflows zur Prüfung von Benutzernamen: Lösen Sie einen übergebenen Handle in ein normalisiertes öffentliches Profil auf, bevor Sie ihn mit einer internen Entität oder einem Recherchegegenstand verknüpfen.
- Vergleiche öffentlicher Konten: Vergleichen Sie die sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen über getrennt übergebene Benutzernamen hinweg, mit derselben Struktur AccountItem.
- Beobachtung von Profiländerungen: Speichern Sie nullable Identitätsfelder und Kennzahlen zusammen mit collected_at, damit spätere Läufe als öffentliche Momentaufnahmen unterscheidbar bleiben.
Profi-Tipps zur Twitch Profile API
- Übergeben Sie einen Benutzernamen statt der URL eines Twitch-Kanals; url und results_limit sind für diesen Endpunkt keine akzeptierten Anfragefelder.
- Verwenden Sie höchstens ein optionales führendes @; Leerzeichen, Schrägstriche, Nicht-ASCII-Zeichen und wiederholte @-Zeichen verletzen die Laufzeitregel für Benutzernamen.
- Rechnen Sie mit null oder einem Quelldatensatz zum Profil. Deuten Sie den Parameter limit des Aufgabenlesers nicht als Möglichkeit, ein Profil zu Videos oder Followern zu erweitern.
- Behandeln Sie ID, URL, Biografie, Bilder, Website, Kontomerkmale, Standort und jede Kennzahl als nullable und bewahren Sie collected_at für Vergleiche von Momentaufnahmen auf.
- Verwenden Sie für Videos oder Clips, sofern verfügbar, separate Twitch-Inhaltsendpunkte; dieser Endpunkt ist eine reine Leseabfrage eines Profils und meldet nicht an, veröffentlicht nicht, moderiert nicht und verwaltet keinen Kanal.
Verwandte APIs
Ergänzend zur Twitch Profile API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Twitch-Daten benötigen.
- Twitch User Videos API
- 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.