douyin/
user-profile

Récupérez un profil Douyin public à partir d’une URL de profil prise en charge ou d’un identifiant d’utilisateur et obtenez identité normalisée, biographie, images, indicateurs de compte et nombres visibles.

Douyin User Profile API

URL ou ID d’utilisateur
Un seul profil public
Champs de compte normalisés
0,1 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

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ètresObligatoireDescription
urlObligatoire (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_idObligatoire (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.

  1. Préparez soit une URL complète de profil Douyin avec un chemin /user/<identifier>, soit un user_id public pris en charge.
  2. Envoyez un seul identifiant en POST à /v1/douyin/user-profile et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut vaille succeeded ou failed.
  4. 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.items

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

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.

Explorer d’autres plateformes

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

Douyin User Profile API — FAQ

Douyin User Profile API récupère un compte Douyin public à partir d’une URL de profil prise en charge ou d’un identifiant d’utilisateur, et renvoie l’identité normalisée, la biographie, les images, les indicateurs de compte, les nombres visibles et l’heure de collecte.

L’un ou l’autre champ satisfait l’exigence de la requête. N’envoyez que l’identifiant à résoudre, car user_id prévaut lorsque les deux valeurs sont présentes.

Le nom d’hôte analysé doit être douyin.com, iesdouyin.com ou un sous-domaine, et le chemin doit contenir /user/ suivi d’un identifiant composé de lettres, de chiffres, de tirets bas ou de traits d’union. Les liens de vidéos et les hôtes sans rapport sont rejetés.

Le schéma de compte peut contenir l’ID et l’URL du profil, le nom d’utilisateur, le nom affiché, la biographie, l’avatar, l’image de couverture, le site web, les indicateurs de vérification et de confidentialité, la localisation, le nombre d’abonnés, le nombre d’abonnements, le nombre de publications et collected_at. Les champs publics facultatifs restent à null lorsqu’aucune valeur n’est disponible.

Non. La recherche auprès du fournisseur est une requête de détail unique qui produit au plus un profil source ; next_cursor et has_more décrivent uniquement la pagination des résultats déjà stockés par SocQ.

Chaque tâche réussie a un coût fixe de 0,10 crédit SocQ. Ce montant ne dépend pas du nombre de champs de profil facultatifs renseignés.