twitch/
profile

Lösen Sie einen öffentlichen Twitch-Benutzernamen in einen normalisierten Profildatensatz mit Identität, Biografie, Bildmaterial, Kontomerkmalen, sichtbaren Kennzahlen und Erfassungskontext auf.

Twitch Profile API

Eingabe eines einzelnen Benutzernamens
Normalisierter Kontodatensatz
Feste Kosten pro Anfrage
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 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

ParameterErforderlichBeschreibung
usernameErforderlichErforderlicher 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.

  1. Wählen Sie einen öffentlichen Twitch-Benutzernamen, der der unterstützten Zeichenregel entspricht.
  2. Senden Sie username per POST an /v1/twitch/profile und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
  4. 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.items

Anwendungsfä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.

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

Weitere Plattformen entdecken

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

Twitch Profile API — FAQ

Twitch Profile API ist eine Schnittstelle, die aus einem öffentlichen Twitch-Benutzernamen einen normalisierten Kontodatensatz abruft, einschließlich verfügbarer Identität, Biografie, Bildmaterial, Kontomerkmalen, Standort, Kennzahlen und Erfassungszeitpunkt.

Nach dem Zuschneiden akzeptiert username ein optionales führendes @, gefolgt von 1 bis 64 ASCII-Buchstaben, Zahlen, Punkten, Unterstrichen oder Bindestrichen. Leerzeichen, Schrägstriche, zusätzliche @-Zeichen und andere Zeichen werden abgelehnt.

Nein. Die Anfragespezifikation akzeptiert genau einen erforderlichen username und lehnt vom Aufrufer gelieferte Felder wie usernames, url, urls und results_limit ab.

Der Anbieterpfad löst für den übergebenen Benutzernamen höchstens ein Profilobjekt auf. Abgeschlossene Ergebnisse verwenden weiterhin die gemeinsame Hülle für gespeicherte Ergebnisse mit den Feldern limit, has_more und next_cursor.

Die normalisierte Spezifikation erlaubt null-Werte für ID, URL, Benutzername, Name, Biografie, Bildmaterial, Website, Verifizierung, Datenschutz, Standort und einzelne Kennzahlen, wenn öffentliche Quelldaten nicht verfügbar sind.

Jede erfolgreiche Aufgabe kostet pauschal 0,19 SocQ-Credits. Der feste Betrag hängt nicht davon ab, wie viele optionale Felder im einzelnen Profilergebnis befüllt sind.