youtube/
comments

Collectez les commentaires YouTube publiquement visibles à partir d’une ou plusieurs URL de vidéos, avec texte, auteurs, mentions « J’aime », nombres de réponses, vidéos sources et contexte de conversation normalisés.

YouTube Comments API

Commentaires
Données de discussion
URL de vidéos
0,3 crédit par résultat
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

YouTube Comments

Les commentaires YouTube sont les réactions publiques des spectateurs à une vidéo, avec texte, contexte de l’auteur, heure de publication, mentions « J’aime » visibles, nombre de réponses, détails de la vidéo source et relations de conversation. Ces signaux de discussion nourrissent l’analyse des retours, l’étude d’audience, la revue de sujets et le suivi des réactions.

Fonctionnalités de la YouTube Comments API

  • Collecte de commentaires sur plusieurs vidéosRécupérez en une seule requête les commentaires publics de plusieurs URL de vidéos.
  • Limites et tri par vidéoDéfinissez un results_limit par vidéo et choisissez l’ordre newest (plus récents) ou relevance (pertinence).
  • Champs de commentaire et d’auteurID du commentaire, texte, informations publiques de l’auteur, heure de publication et informations sur la vidéo source sont renvoyés.
  • Relations entre commentairesLe nombre public de mentions « J’aime », le nombre de réponses et l’ID du commentaire parent sont inclus pour une analyse structurée des discussions.
  • Indicateurs d’interaction du créateurLes indicateurs de propriétaire de la chaîne et de cœur du créateur sont conservés lorsqu’ils figurent dans le résultat public.

Paramètres de la YouTube Comments API

ParamètresObligatoireDescription
urlsObligatoireURL de vidéos YouTube publiques dont les commentaires sont visibles, séparées par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal d’enregistrements éligibles à demander pour chaque URL fournie. Doit être un entier positif ; vaut 100 par défaut.
sort_byFacultatifOrdre des commentaires. Vaut newest par défaut ; relevance reprend le classement public de YouTube.

Comment utiliser la YouTube Comments API

Décidez si c’est la fraîcheur ou la visibilité qui compte, fixez un budget d’échantillonnage par vidéo et préservez les relations renvoyées quand les commentaires entrent dans votre pipeline d’analyse.

  1. Choisissez des URL de vidéos publiques et précisez si vous voulez des réactions du moment ou la discussion classée par YouTube.
  2. Envoyez urls, results_limit et sort_by en POST à /v1/youtube/comments ; la limite s’applique à chaque vidéo.
  3. Interrogez /v1/tasks/{task_id} en laissant, dans un même lot, se résoudre les vidéos avec commentaires activés et celles dont la section est indisponible.
  4. En cas de réussite, dédoublonnez par ID de commentaire, reliez les réponses avec parent_comment_id et paginez tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"results_limit":10,"sort_by":"newest"}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Cas d’usage de la YouTube Comments API

  • Analyse des retours de l’audience : Analysez le texte des commentaires publics pour dégager sentiments, questions récurrentes, thèmes et idées de contenu.
  • Suivi de campagnes et d’événements : Suivez les réactions publiques à des créateurs, des lancements de produits, des campagnes, des annonces ou des événements.
  • Étude des discussions : Exploitez mentions « J’aime », nombres de réponses et références au commentaire parent pour étudier les commentaires très engageants et les fils actifs.
  • Jeux de données d’analyse de texte : Alimentez en commentaires normalisés des workflows de classification, de clustering, de résumé, d’aide à la modération ou d’alerte.

Conseils d’expert pour la YouTube Comments API

  • Choisissez sort_by avant l’analyse. Passer de relevance à newest change l’échantillon : les deux exports ne se comparent donc pas comme si seul leur ordre avait changé.
  • Voyez results_limit comme un plafond par vidéo. Commentaires désactivés, modération, classement, restrictions et faible activité peuvent tous réduire le nombre renvoyé.
  • Servez-vous de l’ID du commentaire pour dédoublonner et de parent_comment_id pour relier, mais ne supposez pas que chaque réponse visible figure dans la même page de résultats.
  • Les totaux de mentions « J’aime » et de réponses sont des observations faites au moment de la collecte, pas des mesures figées du sentiment ou de l’importance.
  • Le texte des commentaires et les champs d’auteur sont des entrées publiques non fiables. Échappez-les dans vos interfaces et validez les URL qu’ils contiennent avant de les utiliser.
  • Une correspondance de mot-clé n’est pas une analyse de sentiment. Conservez le texte d’origine et le contexte source quand vous appliquez des étiquettes ou des résumés.
  • Gardez l’ID de vidéo et collected_at sur chaque ligne, pour que les analystes puissent retrouver quel échantillon de conversation ils ont examiné.

En complément de la YouTube Comments API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques YouTube.

  • YouTube Channel Videos API — Collectez les vidéos publiques classiques à partir d’URL de chaînes, hors Shorts et lives.
  • YouTube Transcripts API — Récupérez les transcriptions en texte brut disponibles, avec choix facultatif de la langue.
  • YouTube Channels API — Récupérez l’identité publique d’une chaîne, ses images, sa vérification et ses statistiques d’audience visibles.
  • YouTube Videos API — Récupérez les métadonnées, miniatures, durée et l’engagement à partir d’URL de vidéos ou de Shorts connues.
  • YouTube Comment Replies API — Poursuivez un fil de commentaires YouTube connu à partir de son jeton de réponses et obtenez les réponses publiques, auteurs, l’engagement et le contexte parent.
  • YouTube Community Post Comments API — Collectez les commentaires d’une publication de la communauté à partir de son lien, avec chaînes des auteurs, nombres de mentions « J’aime » et nombres de réponses.

Explorer d’autres plateformes

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

YouTube Comments API — FAQ

YouTube Comments API collecte les commentaires publiquement visibles d’une ou plusieurs URL de vidéos YouTube. Elle renvoie le texte, les informations sur l’auteur, l’heure de publication, les mentions « J’aime », les nombres de réponses, les références de la vidéo source, les ID de commentaires parents et l’heure de collecte, le tout normalisé.

Envoyez une ou plusieurs URL de vidéos YouTube publiques, ainsi qu’un results_limit et une valeur sort_by facultatifs.

Utilisez newest pour obtenir d’abord les commentaires les plus récents, ou relevance pour l’ordre de pertinence public de YouTube. newest est la valeur par défaut.

Les enregistrements de réponses peuvent contenir parent_comment_id, tandis que replies_count indique le nombre public de réponses associées à un commentaire.

results_limit est un maximum par vidéo. Les vidéos dont les commentaires sont désactivés, filtrés, restreints ou moins nombreux à être publiquement visibles peuvent renvoyer moins d’enregistrements, voire un résultat vide.

L’utilisation coûte 0,3 crédit pour chaque résultat de commentaire normalisé renvoyé.