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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire (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_id | Obligatoire (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_limit | Facultatif | Nombre 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.
- Préparez soit une URL de profil Douyin sur douyin.com ou iesdouyin.com avec un chemin /user/{identifier}, soit un user_id connu.
- Envoyez l’identité et, si vous le souhaitez, un results_limit de 1 à 20 en POST à /v1/douyin/user-videos, puis conservez task_id.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- 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 resultsCas 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.
API associées
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.
- 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 Profile API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API