douyin/
user-videos

Collectez jusqu’à 20 vidéos publiques d’une URL de profil Douyin ou d’un ID d’utilisateur connu et obtenez contenu normalisé, auteur, médias, durée, horodatages et champs d’engagement visibles.

Douyin User Videos API

URL de profil ou ID d’utilisateur
Jusqu’à 20 vidéos
Enregistrements vidéo 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 Videos

Cet endpoint convertit l’identité d’un créateur Douyin en un lot d’une seule page d’enregistrements de vidéos publiques. Chaque enregistrement peut porter sa légende, le contexte de l’auteur, l’URL source, les dates de publication et de collecte, les médias, la durée et les nombres visibles de lectures, de mentions J’aime, de commentaires, de partages ou de vues, lorsque la source les fournit.

Fonctionnalités de la Douyin User Videos API

  • Deux façons d’identifier un créateurEnvoyez une URL de profil Douyin prise en charge ou un user_id connu. Si les deux champs sont présents, c’est le user_id direct qui est utilisé.
  • Périmètre explicite d’une pageDemandez de 1 à 20 résultats, 20 étant à la fois la valeur par défaut et le maximum ; la requête adressée au fournisseur part toujours de sa première page.
  • Vidéo et contexte du créateur réunisGardez dans chaque enregistrement vidéo les légendes normalisées, les champs publics de l’auteur, les URL sources, les horodatages, les références média et la durée.
  • Champs d’engagement prêts pour l’observationConservez les lectures, mentions J’aime, commentaires, partages et vues disponibles avec collected_at, pour que chaque nombre visible reste lié à son heure de collecte.

Paramètres de la Douyin User Videos API

ParamètresObligatoireDescription
urlObligatoire (au moins un)Référence de profil Douyin dont le nom d’hôte est douyin.com, iesdouyin.com ou un sous-domaine, et dont le chemin contient /user/{identifier}. Fournissez url ou user_id ; user_id prévaut lorsque les deux sont présents.
user_idObligatoire (au moins un)Identifiant d’utilisateur connu, composé de 1 à 256 lettres ASCII, chiffres, deux-points, tirets bas ou traits d’union. Fournissez user_id ou url.
results_limitFacultatifNombre d’enregistrements demandé sur l’unique page du fournisseur. Accepte les entiers de 1 à 20 et vaut 20 par défaut.

Comment utiliser la Douyin User Videos API

Envoyez l’identité d’un créateur public, suivez la tâche asynchrone, puis lisez les enregistrements vidéo normalisés stockés.

  1. Préparez soit une URL de profil Douyin sur douyin.com ou iesdouyin.com avec un chemin /user/{identifier}, soit un user_id connu.
  2. Envoyez l’identité et, si vous le souhaitez, un results_limit de 1 à 20 en POST à /v1/douyin/user-videos, puis conservez task_id.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez data.results.items ; ne suivez next_cursor que pour les enregistrements supplémentaires déjà stockés par SocQ, et non pour obtenir une autre page du fournisseur.
curl -X POST "https://api.socq.ai/v1/douyin/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"'"$DOUYIN_PROFILE_URL"'","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and use next_cursor only for stored results

Cas d’usage de la Douyin User Videos API

  • Instantanés du fil d’un créateur : Enregistrez un ensemble borné de vidéos publiques et leurs horodatages de collecte pour un créateur, à un moment d’observation choisi.
  • Enrichissement d’un catalogue de vidéos : Ajoutez légendes normalisées, identité de l’auteur, URL sources, date de publication, durée et médias disponibles à une fiche de créateur existante.
  • Revue des créations et des formats : Examinez les légendes, durées et champs média renvoyés pour classer les vidéos disponibles selon leur traitement de contenu ou leur format.
  • Comparaison de l’engagement au sein d’un instantané : Comparez les lectures, mentions J’aime, commentaires, partages et vues disponibles entre les vidéos renvoyées, en conservant collected_at.

Conseils d’expert pour la Douyin User Videos API

  • Privilégiez un seul champ d’identité par requête. Si url et user_id sont tous deux inclus, le backend retient user_id.
  • Validez l’hôte de l’URL et le chemin /user/{identifier} avant l’envoi ; une URL de vidéo Douyin générique ne convient pas à cet endpoint.
  • Ne définissez results_limit que si moins des 20 enregistrements par défaut vous suffisent ; il doit s’agir d’un entier de 1 à 20.
  • Ne confondez pas le curseur des résultats de la tâche avec un curseur source Douyin. La requête source porte sur une page, avec son curseur fournisseur fixé à la première page.
  • Acceptez que l’auteur, les médias, la durée, la date de publication et les métriques individuelles facultatifs restent null ou vides, et utilisez id avec collected_at pour stocker les observations.

En complément de la Douyin User Videos 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 Videos API — FAQ

Douyin User Videos API renvoie les enregistrements de vidéos publiques normalisés d’un créateur, avec identité, légende, contexte de l’auteur, URL source, horodatages, médias, durée et champs d’engagement visibles lorsqu’ils sont disponibles.

L’un ou l’autre champ satisfait l’exigence de saisie. Une URL doit utiliser un hôte Douyin pris en charge et contenir /user/{identifier} ; un user_id connu peut être fourni directement et l’emporte si les deux champs sont présents.

Il contrôle le nombre d’enregistrements demandés pour l’unique page du fournisseur. La valeur doit être un entier de 1 à 20 et vaut 20 par défaut.

Un résultat peut inclure des lectures, des mentions J’aime, des commentaires, des partages et des vues. Chaque champ est facultatif : les valeurs sources indisponibles restent null au lieu d’être déduites.

Non. La requête adressée au fournisseur n’utilise que sa première page. Le next_cursor du lecteur de résultats SocQ pagine les enregistrements déjà stockés pour cette tâche.

Chaque tâche Douyin User Videos réussie coûte 0,10 crédit SocQ, tarif fixe, quel que soit le nombre d’enregistrements renvoyés dans la limite de 20.