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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich (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. |
username | Erforderlich (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.
- Bereiten Sie entweder einen Kwai-Benutzernamen oder eine öffentliche Profil-URL auf kwai.com oder kwai-video.com vor.
- Senden Sie url oder username per POST an /v1/kwai/user-posts und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder einen Fehler meldet.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.