Douyin User Profile
Les profils d’utilisateurs Douyin sont des pages de compte publiques qui réunissent identité, biographie, images de profil, signaux de vérification et de confidentialité, ainsi que les nombres visibles d’abonnés, d’abonnements et de publications. Ces champs servent à enrichir des comptes, à vérifier des identités, à suivre des instantanés et à comparer des profils.
Fonctionnalités de la Douyin User Profile API
- Deux identifiants pris en chargeRésolvez un profil public à partir d’une URL d’utilisateur Douyin prise en charge ou d’un user_id conforme à la règle d’identifiant appliquée à l’exécution.
- Identité et présentation du profilRenvoie, dans une seule fiche de compte, l’ID du profil, l’URL publique, le nom d’utilisateur, le nom affiché, la biographie, l’avatar, l’image de couverture et le site web associé, lorsqu’ils sont disponibles.
- Champs d’état du compte explicitesConserve les indicateurs de vérification et de confidentialité disponibles comme valeurs nullables, au lieu de déduire un état lorsque la source publique l’omet.
- Mesures visibles du profilNormalise les nombres d’abonnés, d’abonnements et de publications disponibles, avec collected_at, pour une vue du profil public à un instant précis.
Paramètres de la Douyin User Profile API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire (au moins un) | Fournissez url ou user_id. Une URL non vide doit utiliser douyin.com, iesdouyin.com ou un sous-domaine, et inclure un chemin /user/<identifier>. |
user_id | Obligatoire (au moins un) | Fournissez user_id ou url. user_id accepte de 1 à 256 lettres ASCII, chiffres, deux-points, tirets bas ou traits d’union, et prévaut si les deux champs sont envoyés. |
Comment utiliser la Douyin User Profile API
Envoyez un identifiant de profil pris en charge, suivez la tâche asynchrone, puis lisez le compte normalisé dans l’enveloppe des résultats stockés.
- Préparez soit une URL complète de profil Douyin avec un chemin /user/<identifier>, soit un user_id public pris en charge.
- Envoyez un seul identifiant en POST à /v1/douyin/user-profile et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut vaille succeeded ou failed.
- Lisez data.results.items après le succès ; la recherche côté source produit au plus un profil, mais l’enveloppe des résultats stockés indique tout de même has_more et next_cursor.
curl -X POST "https://api.socq.ai/v1/douyin/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"user_id\":\"${DOUYIN_USER_ID}\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized account from data.results.itemsCas d’usage de la Douyin User Profile API
- Enrichissement d’une fiche de créateur : Ajoutez l’identité Douyin, la biographie, les images, le site web, les indicateurs de compte et les nombres publics disponibles à une fiche de créateur existante.
- Vérifications d’identité de profil : Transformez une URL de profil ou un identifiant d’utilisateur connus en objet de compte homogène avant de le rattacher à une entité interne.
- Comparaisons de comptes publics : Comparez les nombres d’abonnés, d’abonnements et de publications de profils collectés séparément, grâce aux mêmes clés de métriques normalisées.
- Suivi d’instantanés de profil : Stockez les champs d’identité et les métriques publiques avec collected_at pour que les tâches successives restent des observations distinctes à des instants donnés.
Conseils d’expert pour la Douyin User Profile API
- Lorsqu’un identifiant d’utilisateur canonique est déjà disponible, envoyez user_id seul ; si url et user_id divergent, la requête adressée au fournisseur utilise user_id.
- Avant d’envoyer une URL, vérifiez son nom d’hôte et exigez un chemin /user/<identifier>, afin que les liens vers des vidéos ou d’autres ressources Douyin soient rejetés en local.
- Attendez-vous à zéro ou un enregistrement de profil source ; le curseur du lecteur de tâche pagine les éléments SocQ sauvegardés et ne peut pas demander une autre page au fournisseur pour cette recherche.
- Considérez identité, images, site web, indicateurs de compte, localisation et chaque métrique comme nullables, et conservez collected_at pour comparer des instantanés répétés.
API associées
En complément de la Douyin User Profile API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Douyin.
- Douyin Live Room Detail API — Récupérez un live Douyin connu à partir de son ID numérique de salle avec contexte normalisé, identité de l’hôte, médias et nombres d’audience visibles.
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API