kwai/
user-posts

Collectez une page de publications Kwai publiques à partir d’un nom d’utilisateur ou d’une URL de profil prise en charge, avec texte, auteur, médias, hashtags, horodatages et engagement visible sous forme d’enregistrements normalisés.

Kwai User Posts API

Nom d’utilisateur ou URL de profil
Une seule page source
Publications publiques normalisées
0,19 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Kwai User Posts

Les publications d’un utilisateur Kwai sont des contenus publics d’un compte, avec légendes, identité de l’auteur, médias joints, hashtags, mentions, horodatages et nombres d’engagement visibles. Ces champs de contenu et de contexte servent à étudier un compte, examiner les formats de médias et comparer l’engagement à un instant donné.

Fonctionnalités de la Kwai User Posts API

  • Deux entrées d’identité prises en chargePartez d’un nom d’utilisateur ou d’une URL de profil public sur kwai.com ou kwai-video.com ; au moins un champ d’identité doit être présent.
  • Collecte des publications publiques sur une pageRécupérez les publications renvoyées par une page du fournisseur pour le compte public choisi, sans curseur source exposé ni limite de résultats fournie par l’appelant.
  • Contenu et contexte de l’auteur normalisésRecevez le texte de la publication, les champs publics de l’auteur, les URL source, les références de médias, les hashtags, les mentions, la date de publication et la date de collecte dans une structure de publication cohérente.
  • Instantanés de l’engagement visibleGardez les nombres de mentions J’aime, de commentaires, de partages et de vues disponibles avec collected_at, pour que les comparaisons restent ancrées à leur date d’observation.

Paramètres de la Kwai User Posts API

ParamètresObligatoireDescription
urlObligatoire (au moins un)Référence de profil Kwai non vide dont le nom d’hôte analysé est kwai.com, kwai-video.com ou un sous-domaine de l’un des deux. Tout schéma est accepté dès lors qu’une autorité et un nom d’hôte sont présents ; les références relatives au protocole sont aussi acceptées. Fournissez url ou username ; les deux peuvent être fournis.
usernameObligatoire (au moins un)Nom d’utilisateur Kwai avec un @ initial facultatif suivi de 1 à 64 lettres ASCII, chiffres, points, tirets bas ou traits d’union, pour une longueur totale maximale de 65 caractères. Le fournisseur reçoit cette valeur sous le nom handle.

Comment utiliser la Kwai User Posts API

Envoyez une identité Kwai prise en charge, suivez la tâche asynchrone et parcourez les résultats normalisés stockés une fois la tâche terminée.

  1. Préparez un nom d’utilisateur Kwai ou une URL de profil public sur kwai.com ou kwai-video.com.
  2. Envoyez url ou username en POST à /v1/kwai/user-posts, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
  4. Lisez data.results.items et utilisez le next_cursor du résultat de tâche tant que has_more vaut true ; ce curseur pagine les résultats stockés, pas la source 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

Cas d’usage de la Kwai User Posts API

  • Étude du contenu d’un compte public : Passez en revue les légendes, l’attribution des auteurs, les références de médias publics, les hashtags, les mentions et les dates de publication d’un compte choisi.
  • Revue des formats de médias : Regroupez les publications renvoyées selon le type de média disponible, la durée, la miniature et les dimensions, tout en gardant la publication source et son auteur.
  • Comparaison de l’engagement à un instant donné : Comparez les mentions J’aime, commentaires, partages et vues visibles des publications collectées, en vous servant de collected_at pour repérer la fenêtre d’observation.

Conseils d’expert pour la Kwai User Posts API

  • Ramenez les noms d’utilisateur à la forme acceptée avec @ facultatif avant l’envoi, et vérifiez que les hôtes des URL de profil correspondent à kwai.com ou kwai-video.com.
  • N’ajoutez ni cursor ni results_limit à la requête source : chaque tâche demande une page au fournisseur en n’utilisant que les champs d’identité pris en charge.
  • N’utilisez cursor et limit de GET /v1/tasks/{task_id} qu’après l’envoi, pour paginer les résultats de tâche stockés ; limit accepte de 1 à 500 et vaut 50 par défaut.
  • Traitez le texte, les informations d’auteur, chaque métrique, les médias, les hashtags, les mentions et la date de publication comme facultatifs, et ancrez les instantanés avec collected_at.

En complément de la Kwai User Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Kwai.

  • Kwai Profile API — Récupérez un profil Kwai public par nom d’utilisateur ou URL prise en charge, avec identité, visuels, indicateurs de compte, nombres visibles et contexte de collecte normalisés.
  • Kwai Post API — Transformez l’URL d’une publication Kwai publique connue en contenu, auteur, médias, horodatages, entités et engagement visible normalisés.

Explorer d’autres plateformes

Combinez les données Kwai avec les données publiques d’autres plateformes sociales prises en charge.

Kwai User Posts API — FAQ

Kwai User Posts API collecte une page d’enregistrements de publications publiques à partir d’un nom d’utilisateur Kwai ou d’une URL de profil prise en charge. Elle renvoie le contenu normalisé, le contexte de l’auteur, les médias, les horodatages, les hashtags, les mentions et l’engagement visible lorsque ces champs publics sont disponibles.

Fournissez au moins url ou username. Un nom d’utilisateur peut commencer par @ et utiliser des lettres, chiffres, points, tirets bas ou traits d’union ; une URL doit utiliser kwai.com, kwai-video.com ou un sous-domaine de l’un des deux.

Non. Le contrat d’envoi n’a ni results_limit ni curseur source et ne fait qu’une requête au fournisseur. Le curseur de GET /v1/tasks/{task_id} ne pagine que les résultats déjà stockés pour la tâche terminée.

Une publication peut contenir son ID et son URL, le texte, l’identité publique de l’auteur, les nombres visibles de mentions J’aime, de commentaires, de partages et de vues, les médias, les hashtags, les mentions, published_at et collected_at. Les champs source facultatifs peuvent être nuls ou vides.

Chaque tâche réussie coûte un montant fixe de 0,19 crédit SocQ. Le coût ne change pas avec le nombre d’enregistrements de publications renvoyés par cette requête d’une seule page.