- query
- La requête dont provient cette ligne, répétée sur chaque ligne qu'elle a produite. À conserver : c'est la seule chose qui sépare les résultats quand vous soumettez plusieurs requêtes à la fois.
- video_id
- L'id YouTube de la vidéo, toujours onze caractères. La colonne sur laquelle s'appuyer - et sur laquelle dédoublonner, car une même vidéo peut apparaître plusieurs fois dans une exécution.
- title
- Le titre de la vidéo. Il peut porter des espaces en fin de chaîne : nettoyez-le avant de faire des rapprochements ou des regroupements dessus.
- url
- Un lien vers la vidéo. La forme suit
video_type : /watch?v=<id> pour une vidéo classique et /shorts/<id> pour un short. L'id y figure toujours. - channel_title
- Le nom affiché de la chaîne. Porte lui aussi des espaces en fin de chaîne, et peut être vide sur des résultats issus d'une recherche par mot-clé.
- channel_id
- L'id de la chaîne, commençant toujours par
UC. La façon stable de regrouper par chaîne - une chaîne peut se renommer, ceci ne changera pas. Il peut lui aussi être vide sur des résultats de mot-clé. - views
- Le nombre de vues tel que YouTube l'imprime - une chaîne arrondie et abrégée comme
5.6K views. Ce n'est pas toujours un nombre de vues : une vue unique se lit 1 view, et un direct se lit <n> watching, c'est-à-dire des spectateurs simultanés plutôt que des lectures cumulées. - views_parsed
- Le nombre. Malgré son nom, c'est le compte exact et non la chaîne affichée analysée - une vidéo affichant
4.1M views est revenue à 4099999. C'est la colonne sur laquelle sommer, trier et comparer ; views sert à montrer quelque chose à un humain. - published
- Depuis combien de temps avant l'exécution la vidéo est en ligne, sous forme relative -
9 days ago, 2 weeks ago, 3 months ago. Jamais une date absolue, et jamais présent sur un short. Voyez la note ci-dessous sur la façon de l'ancrer. - length
- La durée, en
m:ss ou h:mm:ss. Absente sur un short, et absente sur un direct. - video_type
- Soit
short, soit video, selon le type que vous avez choisi pour l'exécution. Une exécution renvoie l'un ou l'autre : cette colonne est donc constante à l'intérieur d'un fichier - elle sert à distinguer deux fichiers après coup. - thumbnail
- Un lien vers l'image d'aperçu. Le nom de fichier varie -
frame0.jpg sur les shorts, et hqdefault, hq720 et des variantes personnalisées ailleurs - alors lisez la colonne plutôt que de fabriquer l'URL vous-même. L'id de la vidéo y figure toujours.