
Pour une vérification ponctuelle, commencez sur la page publique de la vidéo. Lisez le commentaire, regardez le moment indiqué et vérifiez le contexte des réponses. Utilisez la méthode de collecte ci-dessous pour enregistrer un ensemble que vous pourrez consulter et vérifier à nouveau.
Une proposition publique d’un lecteur, publiée le 20 novembre 2024 ; un problème de navigation signalé décrit la difficulté : « Parcourir la section des commentaires dans un navigateur peut être difficile. » Un index utile doit préserver la discussion tout en facilitant la recherche de ses repères temporels.
Ce guide explique comment créer cet index. Il porte sur une sélection de commentaires publics et de réponses. Il ne couvre pas le chat en direct, les données privées de YouTube Studio ni l’avis de chaque spectateur. Aucune collecte réelle de commentaires n’a été effectuée pour ce guide.
1. Définir le moment de la vidéo et les limites de collecte
Choisissez une vidéo publique connue. Notez son identifiant, son URL publique et sa durée. Un identifiant est un code qui permet de reconnaître un enregistrement source. La durée est le temps de lecture total de la vidéo.
Notez le moment à étudier avant de sélectionner les commentaires. Vous pouvez choisir une position exacte ou un intervalle avec un début et une fin. Précisez si la fin est incluse dans l’intervalle de recherche. Cela évite que vos choix ultérieurs modifient la question.
Une correspondance dans l’index signifie qu’un commentaire contient une référence vérifiée dans cet intervalle. Cela ne signifie pas que vous avez trouvé toutes les discussions sur la scène. Certains commentaires décrivent une scène sans indiquer sa position.
Définissez ensuite les limites de collecte :
| Paramètre | Éléments à noter |
|---|---|
| Vidéo | Identifiant connu et URL de la vidéo publique |
| Durée | Durée totale en secondes et source de la vérification |
| Moment cible | Position exacte ou intervalle défini |
| Ordre des commentaires | Les plus populaires, les plus récents ou les deux |
| Plafond de commentaires | Nombre maximal de commentaires de premier niveau demandés par vidéo |
| Plafond de réponses | Nombre maximal de réponses demandées par commentaire de premier niveau |
| Date et heure de collecte | Moment où les enregistrements ont été collectés |
Un commentaire de premier niveau est un commentaire qui n’est pas une réponse. Un plafond est une limite maximale. Il ne garantit pas que la source renverra autant d’enregistrements.
L’ordre « Les plus populaires » suit le classement mis en avant par la source. L’ordre « Les plus récents » suit son classement par date récente. L’option « Les deux » utilise les deux listes et supprime les identifiants de commentaire répétés pendant l’exécution. Ces choix définissent un échantillon limité. Pour choisir l’ordre, consultez le guide d’échantillonnage des commentaires.
2. Collecter un petit ensemble avec les réponses
Un Actor est un programme hébergé qui collecte des données. Le contrat de YouTube Comments Scraper, vérifié le 25 octobre 2026 ; documentation uniquement décrit la collecte de commentaires publics à partir d’URL ou d’identifiants de vidéos connus. Il décrit aussi la collecte facultative des réponses, avec un plafond.
L’Actor fournit les enregistrements des commentaires. Vous devez extraire les repères temporels, vérifier la vidéo et créer l’index.
Utilisez ces quelques paramètres d’entrée comme point de départ :
{
"startUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
"maxCommentsPerVideo": 20,
"commentSortMode": "newest",
"includeReplies": true,
"maxRepliesPerComment": 5
}Remplacez toute la liste `startUrls` par la vidéo publique souhaitée. L’URL de chanson fournie sert à illustrer le schéma d’entrée. Elle ne prouve pas que cette vidéo fournit des commentaires utiles pour cette méthode.
Ces paramètres demandent jusqu’à 20 commentaires uniques de premier niveau, dans l’ordre « Les plus récents ». Ils demandent aussi jusqu’à 5 réponses pour chaque commentaire de premier niveau collecté. Les réponses occupent des lignes supplémentaires. Elles ne sont pas décomptées du plafond de premier niveau. Ces nombres sont des limites demandées, pas des nombres de résultats renvoyés ni de personnes.
Le schéma d’entrée documenté accepte de 1 à 100 entrées vidéo. `maxCommentsPerVideo` accepte des nombres entiers de 1 à 1 000. Lorsque les réponses sont activées, `maxRepliesPerComment` accepte des nombres entiers de 1 à 100.
Une Task est un ensemble de paramètres d’entrée enregistré. La Task publique d’export des commentaires et réponses, vérifiée le 25 octobre 2026 ; présence de la page uniquement sert de point de départ pour cette collecte. Remplacez sa liste de vidéos d’exemple et vérifiez ses paramètres avant de l’utiliser.
Les paramètres d’entrée fournis ont passé une vérification selon les règles d’entrée documentées. La page publique de la Task et son identifiant ont été trouvés. Aucun paramétrage enregistré ni aucune exécution payante n’ont été vérifiés. Ces vérifications ne prouvent ni la réussite de la collecte ni la collecte complète des réponses.
3. Enregistrer les commentaires séparément des repères temporels
Conservez deux tables. La table des commentaires contient les enregistrements d’origine de la discussion. La table des relations contient les liens entre les commentaires et les positions dans la vidéo. Une relation est un lien enregistré entre deux éléments.
Conservez une seule ligne par identifiant stable de commentaire. Si vous regroupez plusieurs vidéos, utilisez l’identifiant de la vidéo avec celui du commentaire. Ne fusionnez pas des commentaires parce que leur texte est identique.
Enregistrez ces champs de la source lorsqu’ils sont présents :
| Champ | Utilisation |
|---|---|
| `videoId` | Identifier la vidéo |
| `videoUrl` | Ouvrir la vidéo source |
| `commentId` | Identifier le commentaire |
| `parentCommentId` | Relier une réponse à son commentaire parent |
| `isReply` | Distinguer une réponse d’un commentaire de premier niveau |
| `replyDepth` | Conserver le niveau de réponse documenté |
| `text` | Conserver le texte original du commentaire |
| `sortMode` | Conserver l’ordre de la source utilisé pour cette ligne |
| `publishedAt` | Conserver la date exacte de publication lorsqu’elle est disponible |
| `publishedTimeText` | Conserver le libellé affiché du moment de publication |
| `updatedAt` | Conserver la date exacte de mise à jour lorsqu’elle est disponible |
| `scrapedAt` | Noter la date et l’heure de collecte |
| `status` | Conserver le résultat de la ligne |
La ressource des commentaires YouTube, vérifiée le 25 octobre 2026 ; notions d’identité et de temps uniquement distingue l’identifiant d’un commentaire de celui du parent d’une réponse. Son horodatage de publication indique quand le commentaire a été publié. Il ne désigne pas une position dans la vidéo. L’Actor possède ses propres champs documentés.
Laissez les valeurs manquantes telles quelles. Une valeur nulle dans `publishedAt` signifie que la date exacte est indisponible. Elle ne signifie pas zéro. Ne la remplacez pas par `scrapedAt` et ne la convertissez pas en position dans la vidéo.
Conservez les liens vers les commentaires parents, même si ces parents manquent dans votre export. Notez ce manque de contexte. Ne rattachez pas une réponse à un autre commentaire parce que les formulations semblent proches.
4. Extraire chaque repère temporel écrit comme candidat
Un repère temporel est un court fragment de texte qui peut désigner une position dans la vidéo. Par exemple : 37:07 ou 1:02:03. Un candidat est une référence possible que vous n’avez pas encore confirmée.
Lisez le texte original et créez une ligne de relation pour chaque occurrence candidate. Conservez le repère original et la position de son premier caractère. Comptez à partir de zéro : le premier caractère occupe la position 0.
Ne modifiez ni les espaces ni la ponctuation avant de noter les positions. Un autre lecteur doit pouvoir retrouver le même repère dans le texte enregistré. Si vous utilisez une autre règle de comptage, précisez-la et appliquez-la partout.
Votre table des relations doit contenir les champs suivants. Vous les créez pour l’index. Ils ne font pas partie des résultats garantis par l’Actor :
| Champ enregistré | But |
|---|---|
| Identifiant de la vidéo et du commentaire | Retrouver le commentaire source |
| Repère original | Conserver le repère temporel écrit |
| Position de début du repère | Distinguer les occurrences dans un même commentaire |
| Valeur convertie en secondes | Comparer les positions valides avec une même unité |
| Durée connue | Vérifier si la position se trouve dans la vidéo |
| Résultat de validation | Indiquer si le candidat est valide, invalide ou en attente |
| Contexte du commentaire parent | Relier le commentaire parent ou noter le contexte manquant |
| État de vérification | Noter ce que la vérification de la vidéo a établi |
| Annotation | Expliquer brièvement la décision |
| Date et heure de vérification et personne responsable | Noter qui a vérifié la relation et quand |
Un commentaire peut contenir plusieurs repères temporels. Un même repère peut aussi apparaître deux fois dans un commentaire. Gardez ces occurrences distinctes lors de l’extraction. Aucun de ces cas ne crée un commentaire supplémentaire ni une personne supplémentaire.
Une réponse peut traiter du moment indiqué par son commentaire parent sans contenir elle-même de repère temporel. Conservez cette réponse comme contexte. Ne lui inventez ni repère ni référence vérifiée à une scène.
5. Valider le repère avant la conversion
Vérifiez le repère entier avant de calculer les secondes. Ne transformez pas un repère négatif ou mal formé en position valide en n’en prenant qu’une partie.
Appliquez ces règles :
- Acceptez le format minutes-secondes ou le format heures-minutes-secondes.
- Les secondes doivent être inférieures à 60.
- Dans le format avec heures, le groupe central des minutes doit être inférieur à 60.
- Rejetez les valeurs négatives et les groupes invalides.
- Convertissez les repères valides en secondes.
- Comparez le résultat à la durée connue de la vidéo.
Pour les minutes et les secondes, multipliez les minutes par 60, puis ajoutez les secondes :
37:07 = 37 × 60 secondes + 7 secondes = 2 227 secondes.
Pour les heures, les minutes et les secondes, multipliez les heures par 3 600 et les minutes par 60, puis ajoutez les secondes :
1:02:03 = 1 × 3 600 secondes + 2 × 60 secondes + 3 secondes = 3 723 secondes.
Dans le format à deux groupes, les minutes forment le premier groupe. Elles peuvent dépasser 59. Dans le format à trois groupes, les heures forment le premier groupe. Les groupes suivants, minutes et secondes, doivent rester inférieurs à 60.
Ainsi, 37:67 échoue à la validation. Ne le corrigez pas sans le signaler. Conservez le repère original et la raison de son rejet.
Un repère qui dépasse la durée connue doit rester en attente de vérification. Ne le déplacez pas vers la position valide la plus proche. Si la durée est inconnue, laissez la vérification de durée non résolue. Un repère situé exactement à la fin exige aussi une vérification par lecture avant de le qualifier de référence à une scène.
Zéro est différent d’une valeur manquante. Le repère 0:00 désigne le début de la vidéo. Un champ de conversion vide signifie qu’aucune conversion acceptée n’est disponible.
6. Regarder le moment et lire la discussion
Un nombre valide reste un simple candidat. Il peut désigner autre chose. Regardez le moment indiqué avant de le classer.
Pour chaque candidat qui passe les vérifications :
- Ouvrez la vidéo correspondante et allez à la position convertie.
- Regardez et écoutez le passage autour de cette position.
- Lisez le commentaire original.
- Lisez son commentaire parent et les réponses disponibles.
- Notez brièvement ce que vous avez pu confirmer.
- Attribuez un état de vérification.
Utilisez ces états de façon constante :
| État | Signification |
|---|---|
| Référence à une scène vérifiée | La vidéo et la discussion confirment le lien avec ce moment |
| Repère sans rapport | Le texte vérifié utilise le repère pour autre chose que cette position dans la vidéo |
| Non résolu | Un fait ou une source nécessaire n’a pas pu être vérifié |
| Hors périmètre | La référence ne relève pas de l’étude définie |
Gardez les résultats de validation séparés de ces états de vérification. Un repère invalide échoue à une vérification de format. Une référence non résolue manque d’un fait nécessaire. Une référence vérifiée hors de votre intervalle cible peut rester dans l’index général sans figurer dans les résultats ciblés.
Rédigez des annotations qui décrivent le lien. Ne déduisez ni l’intention d’un spectateur ni un avis partagé par le public. Le plafond de réponses peut aussi vous priver d’un contexte utile. Précisez cette limite.
Pour déterminer s’il manque une explication dans un tutoriel, poursuivez avec la vérification des lacunes pédagogiques. Une référence à une scène ne suffit pas à établir une lacune pédagogique. Pour trouver une explication qu’aucun commentaire ne mentionne, utilisez la méthode distincte de navigation par concept.
7. Suivre un exemple fictif original
Tout cet exemple est une fiction originale. La vidéo, les commentaires, la réponse et les notes de visionnage sont inventés pour enseigner la méthode. Ce ne sont pas des résultats de l’Actor. Aucune collecte réelle de commentaires ni aucune vérification par lecture n’ont eu lieu.
La vidéo fictive dure 40:00 :
40 × 60 secondes = 2 400 secondes.
Le commentaire C contient exactement ce texte :
« 37:07 explique le cadre ; 38:10 montre le résultat. »
Les guillemets servent à présenter l’exemple. Ils ne font pas partie du texte du commentaire enregistré. Le premier caractère de 37:07 occupe la position 0.
Conserver un commentaire et deux références
La table des commentaires contient C une seule fois. La réponse R occupe une ligne distincte sous C. Dans cette fiction, R dit : « Cette comparaison m’a aidé. » Elle ne contient aucun repère temporel.
| Identifiant du commentaire | Identifiant du parent | Texte |
|---|---|---|
| C | Aucun ; commentaire de premier niveau | 37:07 explique le cadre ; 38:10 montre le résultat. |
| R | C | Cette comparaison m’a aidé. |
Les deux repères de C produisent deux lignes de relation :
| Identifiant du commentaire | Repère | Position de début, à partir de zéro | Position convertie | Vérification de durée |
|---|---|---|---|---|
| C | 37:07 | 0 | 2 227 secondes | Dans la limite de 2 400 secondes |
| C | 38:10 | 26 | 2 290 secondes | Dans la limite de 2 400 secondes |
Le second repère commence à la position 26. La position 25 est l’espace après le point-virgule. Gardez cette position liée au texte inchangé.
Le second calcul est le suivant :
38:10 = 38 × 60 secondes + 10 secondes = 2 290 secondes.
Les deux références sont espacées de 2 290 − 2 227 = 63 secondes. Cet écart ne crée pas un intervalle de scène continu. Le commentaire désigne deux moments distincts.
Appliquer les notes de visionnage fictives
Supposons que les notes de visionnage fictives confirment le cadre à 37:07 et son résultat à 38:10. Les deux relations reçoivent l’état « Référence à une scène vérifiée ». R reste rattachée à C comme contexte de réponse. Aucune référence temporelle n’est inventée pour R.
| Commentaire | Position | État | Annotation | Contexte des réponses |
|---|---|---|---|---|
| C | 37:07 | Référence à une scène vérifiée | La note de visionnage fictive confirme le cadre | R reste liée à C |
| C | 38:10 | Référence à une scène vérifiée | La note de visionnage fictive confirme le résultat | R reste liée à C |
Pour un intervalle cible allant de 37:00 à 37:30 inclus, seule la première relation entre dans les résultats. La seconde reste dans l’index général. C reste un seul commentaire dans les deux vues.
L’exemple contient deux enregistrements de commentaires, dont une réponse. C contient deux mentions de repères temporels. Ces nombres ne permettent pas d’établir un nombre de personnes.
Garder en attente un repère qui dépasse la durée
Considérez maintenant un autre candidat fictif, 41:00 :
41 × 60 secondes = 2 460 secondes.
2 460 − 2 400 = 60 secondes au-delà de la durée de la vidéo fictive.
Le repère respecte le format, mais échoue à la vérification de durée. Gardez-le en attente et notez la raison. Ne le remplacez pas par 40:00. Ce candidat distinct ne modifie pas les nombres indiqués ci-dessus pour C et R.
8. Vérifier l’export et conserver les états d’échec
Exportez l’index de navigation vérifié avec l’URL de la vidéo, la position vérifiée, l’identifiant du commentaire, le contexte du commentaire parent, une courte annotation et l’état. Conservez à côté les tables d’origine des commentaires et des candidats.
Avant d’utiliser l’index, vérifiez que chaque relation renvoie à un commentaire enregistré. Vérifiez à nouveau les positions des repères dans le texte inchangé. Confirmez les calculs et les unités. Assurez-vous que chaque position acceptée appartient à la bonne vidéo.
Gardez ces échecs visibles :
| Situation | Décision requise |
|---|---|
| Texte manquant | Laisser l’extraction non résolue ; ne pas inventer de mots |
| Identité manquante | Garder l’enregistrement non résolu ; ne pas inventer d’identifiant |
| Repère invalide | Le conserver avec l’échec de validation |
| Durée inconnue | Laisser la vérification de durée non résolue |
| Lecture indisponible | Laisser la vérification de la scène non résolue |
| Commentaire parent ou réponses manquants | Noter le manque de contexte |
| Échec de la collecte | Noter l’échec ; ne pas le traiter comme une collecte réussie avec un échantillon vide |
| Aucune correspondance vérifiée | Signaler l’absence de correspondances vérifiées dans cet ensemble collecté |
Un nombre nul ne s’applique qu’à l’ensemble réellement vérifié. Il ne prouve pas qu’aucun commentaire pertinent n’existe. Présentez séparément le nombre d’identifiants uniques de commentaires et le nombre de mentions de repères temporels. Conservez avec ces nombres l’ordre de la source, les plafonds, les dates de collecte et les enregistrements non résolus.
Sources et lectures complémentaires
- Contrat public de YouTube Comments Scraper — vérifié le 25 octobre 2026 ; documentation de la version 1.1.6, aucune exécution payante ni aucun test d’exécution
- Task d’export des commentaires et réponses YouTube — vérifiée le 25 octobre 2026 ; page publique et identifiant du paramétrage trouvés, paramètres enregistrés et exécution non vérifiés
- Ressource des commentaires de l’API YouTube Data — vérifiée le 25 octobre 2026 ; notions d’identité du commentaire, d’identité du parent et de moment de publication uniquement
- Proposition publique d’un lecteur sur la navigation dans les commentaires — publiée le 20 novembre 2024, consultée le 25 octobre 2026 ; un problème signalé par un lecteur
Par Chronometrica · Mis à jour
Retour en haut ↑

