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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL obligatoire, stable et publique, de la vidéo YouTube qui contient le commentaire parent. |
comment_id | Obligatoire | ID obligatoire du commentaire de premier niveau appartenant à l’URL de vidéo envoyée. |
results_limit | Facultatif | Nombre 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.
- Choisissez l’URL d’une vidéo YouTube publique et l’ID d’un commentaire de premier niveau renvoyé pour cette vidéo.
- Envoyez url, comment_id et results_limit en POST à /v1/youtube/comment-replies.
- Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} tant que la tâche est queued, running ou retrying.
- 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 trueCas 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.
API associées
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.
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API