douyin/
video-comments

Collectez une page de commentaires publics à partir de l’URL directe d’une vidéo Douyin et obtenez texte normalisé, auteur, relations, date et champs d’engagement visibles.

Douyin Video Comments API

URL directe de vidéo
Une seule page source
CommentItem 1.0
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 Comments

Les commentaires de vidéos Douyin sont des réactions publiques attachées à une vidéo, avec un texte, l’identité de l’auteur, le contexte de publication et des signaux visibles de mentions J’aime ou de réponses. Ces enregistrements servent à étudier les réactions du public, à cartographier les conversations et à comparer l’engagement à un instant donné.

Fonctionnalités de la Douyin Video Comments API

  • Ciblage direct d’une vidéoL’ID numérique de la vidéo est extrait d’une URL publique douyin.com ou iesdouyin.com dont le chemin contient /video/{numeric_id}.
  • Collecte bornée sur une pageDemandez jusqu’à 20 lignes de commentaires issues de la première page source, results_limit réglant le sous-ensemble stocké de 1 à 20.
  • Contexte canonique des commentairesRenvoie des enregistrements CommentItem 1.0 avec texte, identité de l’auteur, relations avec la vidéo et le parent, dates de publication et de collecte, et nombres visibles de mentions J’aime ou de réponses.

Paramètres de la Douyin Video Comments API

ParamètresObligatoireDescription
urlObligatoireURL publique obligatoire sur douyin.com, iesdouyin.com ou un sous-domaine. Son chemin doit contenir /video/ suivi d’un ID de vidéo numérique.
results_limitFacultatifEntier facultatif de 1 à 20. S’il est omis, la valeur par défaut est 20 ; l’intégration ne demande que la première page source.

Comment utiliser la Douyin Video Comments API

Définissez l’URL directe d’une vidéo Douyin publique, envoyez la tâche asynchrone, puis lisez les commentaires normalisés stockés pour cette tâche.

  1. Définissez DOUYIN_VIDEO_URL sur une URL publique douyin.com ou iesdouyin.com avec un chemin /video/{numeric_id}.
  2. Envoyez url et, si vous le souhaitez, results_limit en POST à /v1/douyin/video-comments, 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 et suivez next_cursor tant que has_more vaut true pour parcourir les enregistrements déjà stockés par SocQ.
curl -X POST "https://api.socq.ai/v1/douyin/video-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"${DOUYIN_VIDEO_URL}\",\"results_limit\":20}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Douyin Video Comments API

  • Étude des réactions du public : Servez-vous du texte des commentaires, de l’identité des auteurs et des nombres visibles de mentions J’aime ou de réponses pour examiner les réactions à une vidéo publique connue.
  • Cartographie des relations entre commentaires : Reliez les commentaires renvoyés à la vidéo source et à toute référence parente fournie grâce à post_id et parent_id.
  • Comparaison d’instantanés d’engagement : Comparez les signaux visibles des commentaires entre des vidéos choisies ou des dates de collecte différentes, en gardant collected_at comme horodatage d’observation.

Conseils d’expert pour la Douyin Video Comments API

  • Résolvez un lien partagé ou redirigé vers l’URL finale /video/{numeric_id} acceptée avant de l’envoyer, afin que la validation de l’hôte et du chemin réussisse.
  • Omettez results_limit pour demander 20 lignes, ou choisissez un entier plus petit lorsque seul un sous-ensemble de l’unique page source renvoyée vous intéresse.
  • Réutilisez le task_id d’origine et suivez next_cursor uniquement lorsque has_more vaut true ; ce curseur lit des lignes stockées et ne récupère pas une autre page source.
  • Prenez l’id du commentaire comme clé principale de dédoublonnage, et laissez parent_id ou post_id à null lorsque la ligne source omet une relation.
  • Considérez les détails de l’auteur, published_at et les métriques individuelles comme facultatifs, et utilisez collected_at pour horodater chaque instantané de résultats.
  • Échappez le texte des commentaires avant de l’insérer dans du HTML, car les commentaires publics sont du contenu généré par les utilisateurs.

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

Douyin Video Comments API collecte une page de commentaires publics à partir de l’URL d’une vidéo Douyin dotée d’un chemin numérique, et renvoie le texte normalisé, l’auteur, les relations, la date et les nombres visibles de mentions J’aime ou de réponses.

L’url doit utiliser douyin.com, iesdouyin.com ou un sous-domaine, et son chemin doit contenir /video/ suivi d’un ID numérique. Les chemins de profil, de recherche et ceux qui ne désignent pas une vidéo sont rejetés.

results_limit accepte les entiers de 1 à 20 et vaut 20 par défaut. La tâche demande une seule page source, elle ne peut donc pas se poursuivre sur d’autres pages source.

CommentItem 1.0 comprend les champs de base d’identité et de date, ainsi que text, author, parent_id, post_id et metrics, qui contient likes_count et replies_count. Les champs sources facultatifs restent à null lorsqu’ils sont indisponibles.

Il n’effectue aucune requête distincte de page de réponses. Une ligne renvoyée peut exposer replies_count et un parent_id lorsque la source les fournit, mais ces champs n’impliquent pas que le texte des réponses ait été collecté.

next_cursor appartient à GET /v1/tasks/{task_id} et pagine les enregistrements que SocQ a déjà stockés après le succès. Il ne demande jamais la page source Douyin suivante.

Chaque tâche réussie coûte 0,10 crédit SocQ, tarif fixe, indépendamment de results_limit ou du nombre d’éléments renvoyés ; les tâches en échec suivent le circuit de remboursement de l’exécution.