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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL 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.
- Vérifiez que l’URL comporte un nom d’hôte analysable sur kwai.com, kwai-video.com ou un sous-domaine accepté.
- Envoyez la chaîne url en POST à /v1/kwai/post et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- 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.itemsCas 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.
API associées
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.