kwai/
post

Récupérez une publication Kwai publique à partir d’une URL connue de kwai.com ou de kwai-video.com, avec texte, auteur, médias, horodatages et engagement visible, le tout normalisé.

Kwai Post API

URL de publication connue
Contexte de la publication et de l’auteur
Coût fixe par tâche
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 Post

Les publications Kwai sont des enregistrements de contenu public qui peuvent associer texte et médias à l’identité de l’auteur, à des hashtags, à des mentions, à une date de publication et à un engagement visible. Ces champs servent à enrichir un catalogue d’URL, à examiner des contenus et à comparer à un instant donné des publications choisies.

Fonctionnalités de la Kwai Post API

  • Recherche d’une seule URL connueRésolvez une URL publique de kwai.com, de kwai-video.com ou de leurs sous-domaines, sans ajouter de règle de chemin non vérifiée.
  • Contexte de la publication et de l’auteurRenvoie l’identité de la publication, l’URL source, le texte, la date de publication et, lorsqu’ils sont disponibles, l’ID de l’auteur, son nom d’utilisateur, son nom affiché, l’URL de son profil, son avatar et ses indicateurs de compte.
  • Médias et entités de contenuConserve les références de médias disponibles, les aperçus, les dimensions, la durée, les hashtags et les mentions à côté de l’enregistrement de la publication.
  • Instantané de l’engagement visibleNormalise les nombres de mentions J’aime, de commentaires, de partages et de vues disponibles avec collected_at, pour que l’enregistrement porte une date d’observation claire.

Paramètres de la Kwai Post API

ParamètresObligatoireDescription
urlObligatoireURL obligatoire et non vide dont le nom d’hôte analysable est kwai.com ou kwai-video.com, sous-domaines pris en charge compris. L’exécution n’impose aucun motif de chemin particulier.

Comment utiliser la Kwai Post API

Envoyez une URL Kwai acceptée, suivez la tâche asynchrone et lisez l’enregistrement de publication normalisé une fois la tâche terminée.

  1. Vérifiez que l’URL comporte un nom d’hôte analysable sur kwai.com, kwai-video.com ou un sous-domaine accepté.
  2. Envoyez la chaîne url en POST à /v1/kwai/post et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez data.results.items après un succès. Le fournisseur de détail ne peut sauvegarder qu’une publication au plus, donc has_more devrait normalement valoir false, même si la route de résultats de tâche expose next_cursor.
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.items

Cas d’usage de la Kwai Post API

  • Enrichir un catalogue de publications connues : Remplacez un lien Kwai stocké par l’ID normalisé de la publication, son texte, l’identité de l’auteur, la date de publication et les champs de source.
  • Examiner le contenu de publications choisies : Appuyez-vous sur le texte, les références de médias, les hashtags, les mentions et le contexte de l’auteur pour inspecter un ensemble approuvé de publications individuelles.
  • Comparer des instantanés d’engagement : Répétez les recherches à des moments définis et associez les nombres visibles de mentions J’aime, de commentaires, de partages et de vues à collected_at pour comparer à un instant donné.

Conseils d’expert pour la Kwai Post API

  • Incluez le schéma de l’URL pour que le nom d’hôte puisse être analysé, et utilisez le lien public exact de la publication plutôt qu’un simple nom de compte.
  • Envoyez une URL par tâche, car cet endpoint de détail accepte un seul champ url et n’offre ni results_limit ni entrée par lot.
  • Conservez l’URL envoyée quand une tâche réussie ne renvoie aucun élément, puisqu’un nom d’hôte accepté ne garantit pas que le fournisseur puisse résoudre la ressource.
  • Stockez prudemment les champs facultatifs d’auteur, de médias, d’entités et d’engagement, car une publication publique n’expose pas forcément tous les champs normalisés.
  • Associez collected_at à chaque comparaison de métriques et ne prenez pas les compteurs visibles pour un flux en direct.

En complément de la Kwai Post 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 User Posts API — Collectez une page de publications Kwai publiques par nom d’utilisateur ou URL de profil prise en charge, avec contenu, auteurs, médias, horodatages, hashtags, mentions 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 Post API — FAQ

Kwai Post API est une interface programmatique qui récupère une publication Kwai publique à partir d’une URL connue sur un hôte Kwai accepté. Elle renvoie l’identité normalisée de la publication, le texte, l’auteur, les médias, les hashtags, les mentions, les horodatages et les champs d’engagement visibles.

Envoyez une URL non vide dont le nom d’hôte analysé est kwai.com, kwai-video.com ou l’un de leurs sous-domaines. Un schéma est nécessaire pour analyser le nom d’hôte.

Le validateur d’exécution actuel n’impose aucun motif de chemin. Utilisez l’URL d’une vraie publication publique, car un chemin de ressource différent peut passer la validation du nom d’hôte tout en ne produisant aucun enregistrement.

Un enregistrement peut contenir l’identité de la publication, l’URL, le texte, les dates de publication et de collecte, les informations sur l’auteur, les médias, les hashtags, les mentions et les nombres visibles de mentions J’aime, de commentaires, de partages et de vues. Les champs publics facultatifs peuvent être nuls.

Aucun results_limit n’est accepté, et une requête au fournisseur ne peut sauvegarder qu’une publication au plus. La route partagée de résultats de tâche expose toujours limit, next_cursor et has_more, mais ce résultat de détail devrait normalement tenir sur sa première page.

Chaque tâche réussie coûte un montant fixe de 0,19 crédit SocQ. L’estimation ne varie pas avec le nombre de résultats, et une tâche réussie qui ne résout aucun enregistrement entraîne tout de même le coût fixe de la tâche.