kwai/
profile

Récupérez un profil Kwai public à partir d’un nom d’utilisateur ou d’une URL de profil prise en charge, avec identité normalisée, visuels de profil, indicateurs de compte, nombres visibles et contexte de collecte.

Kwai Profile API

Nom d’utilisateur ou URL de profil
Identité de profil normalisée
Tâche à 0,19 crédit fixe
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 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ètresObligatoireDescription
usernameObligatoire (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.
urlObligatoire (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.

  1. 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.
  2. Envoyez username, url ou les deux en POST à /v1/kwai/profile et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

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

Kwai Profile API — FAQ

Kwai Profile API est une interface programmatique qui récupère un profil Kwai public à partir d’un nom d’utilisateur ou d’une URL de profil pris en charge. Elle renvoie l’identité normalisée, les visuels de profil, les indicateurs de compte, les nombres visibles et le contexte de collecte lorsqu’ils sont disponibles.

Envoyez username, url ou les deux. Un nom d’utilisateur peut avoir un seul @ initial suivi de 1 à 64 lettres ASCII, chiffres, points, tirets bas ou traits d’union. Une référence d’URL doit s’analyser en kwai.com, kwai-video.com ou un sous-domaine ; tout schéma avec une autorité et un nom d’hôte est accepté, ainsi que les références relatives au protocole.

Un résultat peut contenir l’ID, l’URL source, le nom d’utilisateur, le nom affiché, le texte de la biographie, l’avatar, l’image de couverture, le site web, les indicateurs de vérification et de confidentialité, les nombres visibles d’abonnés, d’abonnements et de publications, ainsi que la date de collecte.

Non. Une tâche résout un seul profil et la requête n’a pas de results_limit. Le lecteur de résultats stockés expose tout de même items, next_cursor et has_more selon le contrat de résultats asynchrones commun.

Chaque tâche Kwai Profile réussie coûte un montant fixe de 0,19 crédit SocQ. Le coût ne varie pas avec le nombre de champs ou d’éléments de résultat.