Kwai Profile
Les profils Kwai sont des pages de compte publiques avec noms d’utilisateur, noms affichés, biographies, visuels de profil, sites web, indicateurs de compte et nombres visibles d’abonnés, d’abonnements et de publications. Ces éléments d’identité et ces signaux datés servent à enrichir des profils, à comparer des comptes et à suivre des instantanés répétés.
Fonctionnalités de la Kwai Profile API
- Deux identifiants pris en chargeRésolvez un profil public à partir d’un nom d’utilisateur valide, d’une URL de profil sur kwai.com ou kwai-video.com, ou des deux identifiants dans une même tâche.
- Identité publique normaliséeRenvoie l’ID du profil, l’URL source, le nom d’utilisateur, le nom affiché, le texte de la biographie, l’avatar, l’image de couverture et le site web dans un enregistrement de compte cohérent.
- Signaux de compte horodatésRéunit les indicateurs de vérification et de confidentialité disponibles, les nombres visibles d’abonnés, d’abonnements et de publications, ainsi que collected_at, pour former un instantané de profil à un instant donné.
Paramètres de la Kwai Profile API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire (au moins un) | username ou url est obligatoire. Un nom d’utilisateur peut commencer par @, suivi de 1 à 64 lettres ASCII, chiffres, points, tirets bas ou traits d’union. |
url | Obligatoire (au moins un) | url ou username est obligatoire. La référence non vide doit s’analyser en un nom d’hôte 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. |
Comment utiliser la Kwai Profile API
Envoyez un identifiant pris en charge, suivez la tâche asynchrone et lisez l’enregistrement de profil normalisé dans la page de résultats stockée.
- Préparez un nom d’utilisateur valide ou une référence de profil Kwai dont le nom d’hôte analysé est kwai.com, kwai-video.com ou un sous-domaine de l’un des deux.
- Envoyez username, url ou les deux en POST à /v1/kwai/profile et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez le profil dans data.results.items et ne suivez next_cursor que si has_more vaut true.
curl -X POST "https://api.socq.ai/v1/kwai/profile" \
-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 next_cursor only while has_more is trueCas d’usage de la Kwai Profile API
- Enrichissement d’un enregistrement de profil : Ajoutez l’identité publique normalisée, les visuels de profil, le site web, les indicateurs de compte et l’URL source à un enregistrement lié à un compte Kwai connu.
- Comparaison des comptes visibles : Comparez les nombres d’abonnés, d’abonnements et de publications disponibles entre des profils choisis, sans prendre ces valeurs pour des totaux en temps réel.
- Suivi par instantanés de profil : Stockez les résultats répétés avec collected_at pour suivre dans le temps les changements des champs d’identité publics, des indicateurs de compte et des nombres visibles.
Conseils d’expert pour la Kwai Profile API
- Fournissez au moins un identifiant. Lorsque username et url sont tous deux présents, le backend transmet les deux au lieu d’en choisir un à votre place.
- Validez les noms d’utilisateur avec ^@?[A-Za-z0-9._-]{1,64}$ et exigez que le nom d’hôte de l’URL analysée soit kwai.com, kwai-video.com ou un sous-domaine avant l’envoi.
- Considérez la biographie, l’avatar, l’image de couverture, le site web, les indicateurs de compte et chaque métrique comme facultatifs, car un profil public peut n’exposer qu’une partie du schéma.
- Prenez id comme clé principale de dédoublonnage, repliez-vous sur url au besoin, et gardez collected_at à côté de chaque instantané de métriques.
API associées
En complément de la Kwai Profile API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Kwai.
- 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.
- 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.