douyin/
video-detail

Transformez l’URL d’une vidéo Douyin connue en enregistrement normalisé avec identité de la vidéo, légende, contexte du créateur, médias, durée, horodatages et champs d’engagement visibles, lorsqu’ils sont disponibles.

Douyin Video Detail API

URL Douyin prise en charge
Une vidéo normalisée
0,10 crédit par tâche
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 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ètresObligatoireDescription
urlObligatoireURL 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.

  1. 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.
  2. Envoyez la chaîne url en POST à /v1/douyin/video-detail et conservez le task_id renvoyé.
  3. 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.
  4. 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.items

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

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.

Explorer d’autres plateformes

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

Douyin Video Detail API — FAQ

Douyin Video Detail API récupère une vidéo Douyin publique à partir d’une URL prise en charge et renvoie un enregistrement vidéo normalisé avec les champs disponibles d’identité, de légende, de créateur, de médias, de durée, d’horodatages et d’engagement visibles.

Utilisez une URL dont le nom d’hôte est douyin.com, iesdouyin.com ou un sous-domaine. Si l’URL contient /video/, l’identifiant qui suit doit être numérique.

Utilisez si possible une référence de vidéo publique directe. Le validateur accepte les hôtes Douyin pris en charge et vérifie un ID numérique chaque fois que /video/ apparaît, mais le fournisseur a quand même besoin d’une référence de vidéo résolvable pour renvoyer des données.

Le schéma de vidéo peut contenir les champs de base d’identité et de date, le texte de la légende, le contexte du créateur, les médias, les hashtags, les mentions, le shortcode, la durée, l’audio et les nombres de mentions J’aime, de commentaires, de partages, de lectures et de vues disponibles. Les champs facultatifs peuvent être null.

Non. Le fournisseur effectue une seule requête de détail et peut stocker au plus un élément. limit, has_more et next_cursor font partie du lecteur de résultats de tâche SocQ partagé, et non d’une pagination du fournisseur.

Le POST renvoie un task_id. Interrogez /v1/tasks/{task_id} ; data.results apparaît une fois la tâche réussie, et un curseur est rejeté tant que la tâche n’est pas terminée.

Chaque tâche réussie entraîne un prélèvement fixe de 0,10 crédit SocQ. Ce montant ne varie pas avec le nombre de résultats, car il s’agit d’une tâche de détail unique à tarif fixe.