kwai/
user-posts

Eine Seite öffentlicher Kwai-Beiträge zu einem Benutzernamen oder einer unterstützten Profil-URL erfassen – mit Text, Autor, Medien, Hashtags, Zeitstempeln und sichtbarer Interaktion als normalisierte Datensätze.

Kwai User Posts API

Benutzername oder Profil-URL
Eine Quellseite
Normalisierte öffentliche Beiträge
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 User Posts

Beiträge von Kwai-Nutzern sind öffentliche Veröffentlichungen eines Kontos mit Bildunterschriften, Identität des Autors, angehängten Medien, Hashtags, Erwähnungen, Zeitstempeln und sichtbaren Interaktionszahlen. Diese Inhalts- und Kontextfelder unterstützen die Kontorecherche, die Prüfung von Medienformaten und den Vergleich der Interaktion zu einem bestimmten Zeitpunkt.

Funktionen der Kwai User Posts API

  • Zwei unterstützte IdentitätseingabenBeginnen Sie entweder mit einem Benutzernamen oder einer öffentlichen Profil-URL auf kwai.com oder kwai-video.com; mindestens ein Identitätsfeld muss vorhanden sein.
  • Erfassung öffentlicher Beiträge von einer SeiteErfasst die Beiträge, die eine Anbieterseite für das ausgewählte öffentliche Konto liefert, ohne einen Quell-Cursor oder ein vom Aufrufer vorgegebenes Ergebnislimit bereitzustellen.
  • Normalisierter Inhalts- und AutorenkontextSie erhalten Beitragstext, öffentliche Autorenfelder, Quell-URLs, Medienverweise, Hashtags, Erwähnungen, Veröffentlichungszeit und Erfassungszeit in einer einheitlichen Beitragsstruktur.
  • Momentaufnahmen der sichtbaren InteraktionBehält vorhandene Zahlen zu Likes, Kommentaren, Shares und Aufrufen zusammen mit collected_at, damit Vergleiche an ihrem Beobachtungszeitpunkt verankert bleiben.

Parameter der Kwai User Posts API

ParameterErforderlichBeschreibung
urlErforderlich (mindestens eines)Ein nicht leerer Kwai-Profilverweis, dessen ausgewerteter Hostname kwai.com, kwai-video.com oder eine Subdomain eines dieser Hosts ist. Jedes Schema wird akzeptiert, sofern Authority und Hostname vorhanden sind; auch protokollrelative Verweise werden akzeptiert. Geben Sie url oder username an; beides zusammen ist möglich.
usernameErforderlich (mindestens eines)Ein Kwai-Benutzername mit einem optionalen führenden @, gefolgt von 1 bis 64 ASCII-Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen, insgesamt höchstens 65 Zeichen. Der Anbieter erhält diesen Wert als handle.

So verwenden Sie die Kwai User Posts API

Senden Sie eine unterstützte Kwai-Identität, verfolgen Sie die asynchrone Aufgabe und blättern Sie nach dem Abschluss durch die gespeicherten normalisierten Ergebnisse.

  1. Bereiten Sie entweder einen Kwai-Benutzernamen oder eine öffentliche Profil-URL auf kwai.com oder kwai-video.com vor.
  2. Senden Sie url oder username per POST an /v1/kwai/user-posts 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 data.results.items und verwenden Sie next_cursor des Aufgabenergebnisses, solange has_more den Wert true hat; dieser Cursor blättert durch gespeicherte Ergebnisse, nicht durch die Quelle bei Kwai.
curl -X POST "https://api.socq.ai/v1/kwai/user-posts" \
  -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 the stored-result next_cursor while has_more is true

Anwendungsfälle der Kwai User Posts API

  • Recherche zu Inhalten öffentlicher Konten: Prüfen Sie Bildunterschriften, Autorenzuordnung, öffentliche Medienverweise, Hashtags, Erwähnungen und Veröffentlichungszeiten eines ausgewählten Kontos.
  • Prüfung von Medienformaten: Gruppieren Sie die zurückgegebenen Beiträge nach verfügbarem Medientyp, Dauer, Vorschaubild und Abmessungen und behalten Sie dabei Quellbeitrag und Autor.
  • Interaktionsvergleich zu einem bestimmten Zeitpunkt: Vergleichen Sie sichtbare Likes, Kommentare, Shares und Aufrufe über die erfassten Beiträge hinweg und bestimmen Sie mit collected_at das Beobachtungsfenster.

Profi-Tipps zur Kwai User Posts API

  • Normalisieren Sie Benutzernamen vor dem Senden auf die akzeptierte Form mit optionalem @ und prüfen Sie die Hosts von Profil-URLs gegen kwai.com oder kwai-video.com.
  • Fügen Sie der Quellanfrage weder cursor noch results_limit hinzu: Jede Aufgabe fordert beim Anbieter eine Seite an und verwendet dabei nur die unterstützten Identitätsfelder.
  • Nutzen Sie cursor und limit von GET /v1/tasks/{task_id} erst nach dem Senden, um durch gespeicherte Aufgabenergebnisse zu blättern; limit akzeptiert 1 bis 500 und hat den Standardwert 50.
  • Behandeln Sie Text, Autorendetails, einzelne Kennzahlen, Medien, Hashtags, Erwähnungen und Veröffentlichungszeit als optional und verankern Sie Momentaufnahmen mit collected_at.

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

  • Kwai Profile API — Ein öffentliches Kwai-Profil per Benutzername oder unterstützter URL abrufen – mit normalisierter Identität, Bildmaterial, Kontomerkmalen, sichtbaren Zahlen und Erfassungskontext.
  • 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 User Posts API — FAQ

Kwai User Posts API erfasst eine Seite öffentlicher Beitragsdatensätze zu einem Kwai-Benutzernamen oder einer unterstützten Profil-URL. Sie liefert normalisierte Inhalte, Autorenkontext, Medien, Zeitstempel, Hashtags, Erwähnungen und sichtbare Interaktion, sofern diese öffentlichen Felder verfügbar sind.

Geben Sie mindestens eines von url oder username an. Ein Benutzername darf mit @ beginnen und Buchstaben, Ziffern, Punkte, Unterstriche oder Bindestriche enthalten; eine URL muss kwai.com, kwai-video.com oder eine Subdomain eines dieser Hosts verwenden.

Nein. Der Vertrag der Anfrage kennt weder results_limit noch einen Quell-Cursor und stellt eine einzige Anfrage an den Anbieter. Der Cursor von GET /v1/tasks/{task_id} blättert nur durch Ergebnisse, die für die abgeschlossene Aufgabe bereits gespeichert sind.

Ein Beitrag kann ID und URL, Text, öffentliche Identität des Autors, die sichtbaren Zahlen zu Likes, Kommentaren, Shares und Aufrufen, Medien, Hashtags, Erwähnungen, published_at und collected_at enthalten. Optionale Quellfelder können null oder leer sein.

Jede erfolgreiche Aufgabe kostet pauschal 0,19 SocQ-Credits. Die Gebühr ändert sich nicht mit der Zahl der Beitragsdatensätze, die diese Anfrage für eine Seite zurückgibt.