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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL 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_limit | Facultatif | Entier 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.
- Définissez DOUYIN_VIDEO_URL sur une URL publique douyin.com ou iesdouyin.com avec un chemin /video/{numeric_id}.
- Envoyez url et, si vous le souhaitez, results_limit en POST à /v1/douyin/video-comments, puis conservez task_id.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- 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 trueCas 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.
API associées
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.
- 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 Detail API
- Douyin Video Search API