- query
- A consulta de onde esta linha veio, repetida em cada linha que produziu. Vale a pena guardar: é a única coisa que separa os resultados quando submete mais do que uma consulta de cada vez.
- video_id
- O id do YouTube para o vídeo, sempre onze caracteres. A coluna por onde indexar - e por onde desduplicar, porque o mesmo vídeo pode aparecer mais do que uma vez numa execução.
- title
- O título do vídeo. Pode trazer espaços no fim, por isso apare antes de comparar ou agrupar por ele.
- url
- Um link para o vídeo. A forma segue
video_type: /watch?v=<id> para um vídeo normal e /shorts/<id> para um short. O id está sempre lá dentro. - channel_title
- O nome visível do canal. Também traz espaços no fim, e pode ficar vazio em resultados que vieram de uma pesquisa por palavra-chave.
- channel_id
- O id do canal, começa sempre por
UC. A forma estável de agrupar por canal - um canal pode mudar de nome e isto não muda. Também pode ficar vazio em resultados de palavra-chave. - views
- A contagem de visualizações tal como o YouTube a imprime - uma cadeia arredondada e abreviada como
5.6K views. Nem sempre é uma contagem de visualizações: uma única visualização lê-se 1 view, e uma transmissão em direto lê-se <n> watching, que são espectadores em simultâneo e não reproduções acumuladas. - views_parsed
- O número. Apesar do nome, esta é a contagem exata e não a cadeia apresentada analisada - um vídeo que mostra
4.1M views voltou como 4099999. É esta a coluna por onde somar, ordenar e comparar; views serve para mostrar a uma pessoa. - published
- Há quanto tempo antes da execução o vídeo foi publicado, como expressão relativa -
9 days ago, 2 weeks ago, 3 months ago. Nunca uma data absoluta, e nunca presente num short. Veja a nota abaixo sobre como a ancorar. - length
- A duração, como
m:ss ou h:mm:ss. Não está presente num short, nem numa transmissão em direto. - video_type
- Ou
short ou video, conforme o tipo de vídeo que escolheu para a execução. Uma execução devolve um ou outro, por isso esta coluna é constante dentro de um ficheiro - está lá para distinguir dois ficheiros depois. - thumbnail
- Um link para a imagem de pré-visualização. O nome do ficheiro varia -
frame0.jpg nos shorts, e hqdefault, hq720 e variantes personalizadas nos restantes -, por isso leia a coluna em vez de construir o URL você mesmo. O id do vídeo está sempre lá.