youtube/
comment-replies

Collectez les réponses YouTube publiques à partir d’une URL de vidéo stable et de l’ID du commentaire parent, avec texte, auteurs, engagement, horodatages et contexte du fil.

YouTube Comment Replies API

Référence de commentaire stable
Réponses publiques
Contexte du fil
0,5 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 Comment Replies

Les réponses à un commentaire YouTube sont des messages publics imbriqués sous un commentaire de premier niveau, avec leur texte, l’identité de l’auteur, les mentions « J’aime » visibles, l’heure de publication et le contexte du commentaire parent ou de la vidéo. Ces enregistrements de fil permettent de reconstituer une conversation, de passer en revue les réponses et de préparer des jeux de données issus de discussions publiques.

Fonctionnalités de la YouTube Comment Replies API

  • Référence de commentaire stablePartez de l’URL publique d’une vidéo et de l’ID de son commentaire parent ; SocQ résout lui-même le jeton de continuation actuel des réponses.
  • Enregistrements de réponses et d’auteursRenvoie les ID de réponses, le texte public, les URL associées, les heures de publication et l’identité normalisée de l’auteur ou de la chaîne.
  • Contexte du fil et du créateurRéunit les mentions « J’aime » visibles, le nombre de réponses imbriquées, les références au commentaire parent et à la vidéo, ainsi que les marqueurs du propriétaire de la chaîne et du cœur du créateur.
  • Collecte bornée par continuationSuit les jetons de continuation successifs de la source, supprime les ID de réponse en double et s’arrête à la limite choisie, à la fin du fil ou au plafond de 100 pages.

Paramètres de la YouTube Comment Replies API

ParamètresObligatoireDescription
urlObligatoireURL obligatoire, stable et publique, de la vidéo YouTube qui contient le commentaire parent.
comment_idObligatoireID obligatoire du commentaire de premier niveau appartenant à l’URL de vidéo envoyée.
results_limitFacultatifNombre maximal de réponses publiques à collecter dans ce fil. L’exemple de la documentation utilise 20 et la plage acceptée va de 20 à 2000.

Comment utiliser la YouTube Comment Replies API

Envoyez l’URL d’une vidéo stable et l’ID d’un commentaire parent sous forme de tâche asynchrone, puis lisez les réponses normalisées dans la tâche terminée.

  1. Choisissez l’URL d’une vidéo YouTube publique et l’ID d’un commentaire de premier niveau renvoyé pour cette vidéo.
  2. Envoyez url, comment_id et results_limit en POST à /v1/youtube/comment-replies.
  3. Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} tant que la tâche est queued, running ou retrying.
  4. Après la réussite, lisez data.results.items et transmettez data.results.next_cursor comme cursor dans la requête de tâche tant que data.results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","comment_id":"Ugzge340dBgB75hWBm54AaABAg","results_limit":20}'

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

Cas d’usage de la YouTube Comment Replies API

  • Reconstitution d’un fil connu : Servez-vous des ID de réponses, de parent_comment_id, de video_id, des URL et des horodatages pour rattacher des réponses déjà enregistrées à un commentaire de premier niveau choisi.
  • Revue de l’audience au niveau des réponses : Comparez, au sein d’un même fil connu, le texte public des réponses, l’identité des auteurs, les mentions « J’aime » visibles, le nombre de réponses imbriquées et les marqueurs d’interaction du créateur.
  • Préparation d’un jeu de données de discussion publique : Rassemblez texte normalisé, auteurs, horodatages et contexte du fil en enregistrements destinés à une revue manuelle ou à un traitement de texte en aval.

Conseils d’expert pour la YouTube Comment Replies API

  • Gardez l’URL de la vidéo et l’ID du commentaire de premier niveau appariés, pour que le fil de réponses et la vidéo source restent alignés.
  • SocQ résout le jeton de continuation actuel en interne ; si un jeton en amont expire, relancez avec la même référence stable.
  • Ne confondez pas l’ID du commentaire source et le curseur renvoyé par GET /v1/tasks/{task_id} : le premier désigne un fil de réponses YouTube, le second parcourt les résultats de tâche enregistrés.
  • Réglez results_limit sur la taille attendue du fil, mais voyez-y un plafond, car la visibilité publique et l’épuisement du fil peuvent réduire le nombre renvoyé.
  • Dédoublonnez les enregistrements sauvegardés par ID de réponse et conservez parent_comment_id, video_id et extra.reply_token pour rattacher les réponses à leur commentaire source.
  • Acceptez des champs auteur, horodatage, indicateur et marqueur de créateur qui peuvent être nuls, et échappez le texte public des réponses avant de l’afficher dans une autre interface.

En complément de la YouTube Comment Replies 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 Comments API — Collectez les commentaires publics, auteurs, l’engagement, vidéos sources et le contexte de la conversation.
  • 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 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 Comment Replies API — FAQ

YouTube Comment Replies API est une interface programmatique pour collecter les réponses publiques à un commentaire YouTube de premier niveau. Envoyez l’URL stable de la vidéo et l’ID du commentaire pour recevoir le texte des réponses, l’identité des auteurs, l’engagement visible, les horodatages et le contexte du fil.

Lancez YouTube Comments API avec l’URL d’une vidéo publique, puis reprenez l’ID d’un commentaire de premier niveau compatible renvoyé pour cette même vidéo.

Non. SocQ résout le jeton de continuation actuel à partir de l’URL de vidéo et de l’ID de commentaire envoyés ; l’ancienne saisie d’un jeton reste un chemin de compatibilité de l’API, mais ce Playground ne l’utilise pas.

results_limit accepte les entiers de 20 à 2000, et l’exemple du Playground envoie 20. La collecte s’arrête à ce plafond, à la fin du fil public ou après 100 pages de la source.

Une réponse peut comprendre son ID, son URL, son texte, les informations publiques de l’auteur ou de la chaîne, les mentions « J’aime » visibles et le nombre de réponses imbriquées, les heures de publication et de collecte, ainsi que le contexte de la vidéo, du commentaire parent, des marqueurs de créateur et du jeton dans extra.

Non. comment_id désigne le fil de réponses YouTube source, tandis que cursor parcourt les enregistrements normalisés déjà sauvegardés dans une tâche SocQ réussie.

Le commentaire parent peut ne pas exposer de jeton de réponses, le fil peut se terminer avant results_limit, ou les réponses peuvent être supprimées, masquées, en attente de modération, réservées aux membres, désactivées ou indisponibles au public pour une autre raison.

Chaque réponse normalisée sauvegardée coûte 0,5 crédit. La facturation suit le nombre réel d’enregistrements sauvegardés : un résultat vide n’entraîne donc aucun frais d’unité de résultat.