kwai/
profile

Ein öffentliches Kwai-Profil per Benutzername oder unterstützter Profil-URL abrufen – mit normalisierter Identität, Profilbildern, Kontokennzeichen, sichtbaren Zahlen und Erfassungskontext.

Kwai Profile API

Benutzername oder Profil-URL
Normalisierte Profilidentität
Feste Aufgabe zu 0,19 Credits
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

Kwai Profile

Kwai-Profile sind öffentliche Kontoseiten mit Benutzernamen, Anzeigenamen, Biografien, Profilbildern, Websites, Kontokennzeichen und den sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen. Diese Angaben zur Identität und die Signale zu einem bestimmten Zeitpunkt unterstützen die Anreicherung von Profilen, den Vergleich von Konten und die Beobachtung durch wiederholte Momentaufnahmen.

Funktionen der Kwai Profile API

  • Zwei unterstützte KennungenLöst ein öffentliches Profil aus einem gültigen Benutzernamen, einer Profil-URL auf kwai.com oder kwai-video.com oder aus beiden Kennungen in derselben Aufgabe auf.
  • Normalisierte öffentliche IdentitätLiefert Profil-ID, Quell-URL, Benutzername, Anzeigename, Biografietext, Avatar, Titelbild und Website in einem einheitlichen Kontodatensatz.
  • Kontosignale mit BeobachtungszeitBehält vorhandene Verifizierungs- und Datenschutzkennzeichen, die sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen sowie collected_at als Momentaufnahme des Profils zusammen.

Parameter der Kwai Profile API

ParameterErforderlichBeschreibung
usernameErforderlich (mindestens eines)Entweder username oder url ist erforderlich. Ein Benutzername darf mit @ beginnen, gefolgt von 1 bis 64 ASCII-Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen.
urlErforderlich (mindestens eines)Entweder url oder username ist erforderlich. Der nicht leere Verweis muss einen Hostnamen von kwai.com, kwai-video.com oder einer Subdomain eines dieser Hosts ergeben. Jedes Schema wird akzeptiert, sofern Authority und Hostname vorhanden sind; auch protokollrelative Verweise werden akzeptiert.

So verwenden Sie die Kwai Profile API

Senden Sie eine unterstützte Kennung, verfolgen Sie die asynchrone Aufgabe und lesen Sie den normalisierten Profildatensatz von der gespeicherten Ergebnisseite.

  1. Bereiten Sie einen gültigen Benutzernamen oder einen Kwai-Profilverweis vor, dessen ausgewerteter Hostname kwai.com, kwai-video.com oder eine Subdomain eines dieser Hosts ist.
  2. Senden Sie username, url oder beides an /v1/kwai/profile und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder einen Fehler meldet.
  4. Lesen Sie das Profil in data.results.items und folgen Sie next_cursor nur, wenn has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/kwai/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.kwai.com/@ShortShortz8"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is true

Anwendungsfälle der Kwai Profile API

  • Profildatensätze anreichern: Ergänzen Sie einen Datensatz zu einem bekannten Kwai-Konto um normalisierte öffentliche Identität, Profilbilder, Website, Kontokennzeichen und Quell-URL.
  • Vergleich sichtbarer Kontozahlen: Vergleichen Sie die vorhandenen Zahlen zu Followern, Gefolgten und Beiträgen ausgewählter Profile, ohne die Werte als Echtzeit-Summen zu behandeln.
  • Beobachtung von Profil-Momentaufnahmen: Speichern Sie wiederholte Ergebnisse mit collected_at, um Änderungen an öffentlichen Identitätsfeldern, Kontokennzeichen und sichtbaren Zahlen im Zeitverlauf zu verfolgen.

Profi-Tipps zur Kwai Profile API

  • Geben Sie mindestens eine Kennung an. Sind username und url beide vorhanden, leitet das Backend beide weiter, statt für Sie eine auszuwählen.
  • Prüfen Sie Benutzernamen mit ^@?[A-Za-z0-9._-]{1,64}$ und verlangen Sie vor dem Senden, dass der ausgewertete URL-Hostname kwai.com, kwai-video.com oder eine Subdomain davon ist.
  • Behandeln Sie Biografie, Avatar, Titelbild, Website, Kontokennzeichen und einzelne Kennzahlen als optional, denn ein öffentliches Profil legt möglicherweise nur einen Teil des Schemas offen.
  • Verwenden Sie id als primären Schlüssel zur Deduplizierung, weichen Sie bei Bedarf auf url aus und behalten Sie collected_at bei jeder Momentaufnahme von Kennzahlen.

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

  • Kwai User Posts API — Eine Seite öffentlicher Kwai-Beiträge per Benutzername oder unterstützter Profil-URL erfassen – mit normalisierten Inhalten, Autoren, Medien, Zeitstempeln, Hashtags, Erwähnungen und sichtbaren Interaktionen.
  • Kwai Post API — Eine bekannte öffentliche Kwai-Beitrags-URL in normalisierte Inhalte, Autor, Medien, Zeitstempel, Entitäten und sichtbare Interaktionen auflösen.

Weitere Plattformen entdecken

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

Kwai Profile API — FAQ

Kwai Profile API ist eine Schnittstelle, die ein öffentliches Kwai-Profil über einen unterstützten Benutzernamen oder eine Profil-URL abruft. Sie liefert, soweit vorhanden, normalisierte Identität, Profilbilder, Kontokennzeichen, sichtbare Zahlen und Erfassungskontext.

Senden Sie username, url oder beides. Ein Benutzername darf ein führendes @ haben, gefolgt von 1 bis 64 ASCII-Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen. Ein URL-Verweis muss zu kwai.com, kwai-video.com oder einer Subdomain führen; akzeptiert wird jedes Schema mit Authority und Hostname sowie protokollrelative Verweise.

Ein Ergebnis kann ID, Quell-URL, Benutzername, Anzeigename, Biografietext, Avatar, Titelbild, Website, Verifizierungs- und Datenschutzkennzeichen, die sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen sowie die Erfassungszeit enthalten.

Nein. Eine Aufgabe löst ein Profil auf, und die Anfrage kennt kein results_limit. Der Leser für gespeicherte Ergebnisse stellt dennoch items, next_cursor und has_more nach dem gemeinsamen Vertrag für asynchrone Ergebnisse bereit.

Jede erfolgreiche Aufgabe von Kwai Profile kostet pauschal 0,19 SocQ-Credits. Die Gebühr hängt nicht von der Zahl der Felder oder Ergebniselemente ab.