Kwai Post
Kwai-Beiträge sind öffentliche Inhaltsdatensätze, die Text und Medien mit Identität des Autors, Hashtags, Erwähnungen, Veröffentlichungszeit und sichtbarer Interaktion verbinden können. Diese Felder unterstützen die Anreicherung von URL-Katalogen, die inhaltliche Prüfung und den Vergleich ausgewählter Beiträge zu bestimmten Zeitpunkten.
Funktionen der Kwai Post API
- Abfrage einer einzelnen bekannten URLLöst eine öffentliche URL auf kwai.com, kwai-video.com oder deren Subdomains auf, ohne eine ungeprüfte Pfadregel hinzuzufügen.
- Beitrags- und AutorenkontextLiefert Beitragsidentität, Quell-URL, Text, Veröffentlichungszeit sowie, soweit vorhanden, Autoren-ID, Benutzername, Anzeigename, Profil-URL, Avatar und Kontokennzeichen.
- Medien und InhaltsentitätenBehält vorhandene Medienverweise, Vorschauen, Abmessungen, Dauer, Hashtags und Erwähnungen beim Beitragsdatensatz.
- Momentaufnahme der sichtbaren InteraktionNormalisiert die vorhandenen Zahlen zu Likes, Kommentaren, Shares und Aufrufen zusammen mit collected_at, sodass der Datensatz einen klaren Beobachtungszeitpunkt hat.
Parameter der Kwai Post API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche, nicht leere URL mit einem auswertbaren Hostnamen auf kwai.com oder kwai-video.com, einschließlich unterstützter Subdomains. Die Laufzeit verlangt kein bestimmtes Pfadmuster. |
So verwenden Sie die Kwai Post API
Senden Sie eine akzeptierte Kwai-URL, verfolgen Sie die asynchrone Aufgabe und lesen Sie nach dem Abschluss den normalisierten Beitragsdatensatz.
- Stellen Sie sicher, dass die URL einen auswertbaren Hostnamen auf kwai.com, kwai-video.com oder einer akzeptierten Subdomain enthält.
- Senden Sie den String url per POST an /v1/kwai/post und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
- Lesen Sie nach einem Erfolg data.results.items. Der Detailanbieter kann höchstens einen Beitrag speichern, daher sollte has_more normalerweise false sein, obwohl die Route für Aufgabenergebnisse next_cursor bereitstellt.
curl -X POST "https://api.socq.ai/v1/kwai/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.kwai.com/@ShortShortz8/photo/5235021727595785285"}'
# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.itemsAnwendungsfälle der Kwai Post API
- Katalog bekannter Beiträge anreichern: Ersetzen Sie einen gespeicherten Kwai-Link durch normalisierte Beitrags-ID, Text, Identität des Autors, Veröffentlichungszeit und Quellfelder.
- Ausgewählte Beitragsinhalte prüfen: Nutzen Sie Text, Medienverweise, Hashtags, Erwähnungen und Autorenkontext, um eine freigegebene Menge einzelner Beiträge zu untersuchen.
- Interaktions-Momentaufnahmen vergleichen: Wiederholen Sie Abfragen zu festgelegten Zeitpunkten und verbinden Sie die sichtbaren Zahlen zu Likes, Kommentaren, Shares und Aufrufen mit collected_at für den Vergleich zu bestimmten Zeitpunkten.
Profi-Tipps zur Kwai Post API
- Geben Sie ein URL-Schema an, damit sich der Hostname auswerten lässt, und verwenden Sie den genauen öffentlichen Beitragslink statt eines bloßen Kontonamens.
- Senden Sie pro Aufgabe eine URL, denn dieser Detail-Endpunkt akzeptiert nur ein einzelnes Feld url und kennt weder results_limit noch eine Batch-Eingabe.
- Bewahren Sie die gesendete URL auf, wenn eine erfolgreiche Aufgabe kein Element zurückgibt, denn ein akzeptierter Hostname garantiert nicht, dass der Anbieter die Ressource auflösen kann.
- Speichern Sie optionale Felder zu Autor, Medien, Entitäten und Interaktion defensiv, denn ein öffentlicher Beitrag legt möglicherweise nicht jedes normalisierte Feld offen.
- Verwenden Sie collected_at bei jedem Zahlenvergleich und behandeln Sie die sichtbaren Zähler nicht als Live-Feed.
Verwandte APIs
Ergänzend zur Kwai Post 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 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.