Douyin Video Detail
Un enregistrement de détail de vidéo Douyin relie l’URL d’une vidéo publique connue à un contenu, un créateur, des médias, des repères temporels et des champs d’engagement visibles, le tout normalisé. Il est utile lorsqu’un workflow dispose déjà du lien exact d’une vidéo et veut un enregistrement homogène pour l’enrichir, la vérifier ou la comparer plus tard.
Fonctionnalités de la Douyin Video Detail API
- URL Douyin prise en chargeAcceptez une URL sur douyin.com, iesdouyin.com ou un sous-domaine pris en charge. Lorsque /video/ apparaît, il doit être suivi d’un ID numérique.
- Résultat borné à une seule vidéoExécute une requête de détail auprès du fournisseur et stocke au plus un enregistrement vidéo normalisé, sans pagination côté source ni results_limit.
- Légende et contexte du créateurRenvoie le texte disponible de la vidéo avec l’ID normalisé du créateur, son nom d’utilisateur, son nom affiché, l’URL de son profil, son avatar et ses indicateurs de compte.
- Champs de médias et de duréeConserve les références de vidéo ou d’image disponibles, les aperçus, les dimensions, la durée du média et le champ normalisé duration_seconds.
- Instantané d’engagement horodatéAssocie les nombres de mentions J’aime, de commentaires, de partages, de lectures et de vues disponibles à published_at et collected_at, plutôt que de les présenter comme des compteurs en direct.
Paramètres de la Douyin Video Detail API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL obligatoire et non vide sur douyin.com, iesdouyin.com ou un sous-domaine pris en charge. Si /video/ est présent, il doit être suivi d’un ID numérique ; une seule URL est acceptée par tâche. |
Comment utiliser la Douyin Video Detail API
Envoyez l’URL d’une vidéo Douyin prise en charge, suivez la tâche asynchrone, puis lisez son résultat normalisé stocké une fois la tâche réussie.
- Définissez DOUYIN_VIDEO_URL sur une URL publique dont l’hôte est douyin.com, iesdouyin.com ou un sous-domaine. Un segment /video/, lorsqu’il est présent, doit être suivi d’un ID numérique.
- Envoyez la chaîne url en POST à /v1/douyin/video-detail et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue ; les champs de résultat ne sont pas disponibles tant qu’elle n’est pas terminée.
- Après le succès, lisez data.results.items. Le fournisseur produit au plus un élément, tandis que limit et next_cursor relèvent du lecteur de résultats stockés de SocQ.
curl -X POST "https://api.socq.ai/v1/douyin/video-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$DOUYIN_VIDEO_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized video from data.results.itemsCas d’usage de la Douyin Video Detail API
- Enrichir des catalogues de vidéos connues : Ajoutez identité normalisée, légende, créateur, date de publication, durée, médias et champs de source à des liens de vidéos Douyin approuvés.
- Relier la découverte au détail : Réutilisez l’URL d’une vidéo prise en charge, conservée depuis un enregistrement de vidéos d’utilisateur ou de recherche de vidéos Douyin, comme entrée exacte d’une recherche de détail ciblée.
- Préparer des comparaisons à un instant donné : Stockez des résultats réussis répétés avec collected_at pour comparer, selon un calendrier défini, les instantanés d’engagement public disponibles.
Conseils d’expert pour la Douyin Video Detail API
- Utilisez une référence de vidéo publique directe sur un nom d’hôte pris en charge pour que le fournisseur puisse la résoudre ; si elle contient /video/, laissez l’ID numérique de la vidéo intact.
- Laissez le champ du Playground vide tant que vous n’avez pas une vraie URL de vidéo publique ; cet endpoint n’a pas de valeur par défaut universelle fiable.
- Envoyez une URL par tâche et omettez results_limit, cursor et les ID sans rapport, car la requête publique n’accepte que url.
- Considérez les champs de créateur, de médias, d’audio, de hashtags, de mentions ou d’engagement manquants comme indisponibles, et non comme des chaînes vides ou des zéros.
- Utilisez collected_at pour comparer les métriques et published_at pour la chronologie des contenus ; ils décrivent des moments différents.
- Si vous poursuivez avec les commentaires de la vidéo, transmettez une URL de vidéo prise en charge à cet endpoint distinct au lieu de supposer que la tâche de détail s’étend aux commentaires.
API associées
En complément de la Douyin Video Detail 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 User Videos API
- Douyin Video Comments API
- Douyin Video Search API