- query
- La consulta de la que salió esta fila, repetida en cada fila que produjo. Conviene conservarla: es lo único que separa los resultados cuando envías más de una consulta a la vez.
- video_id
- El id de YouTube para el vídeo, siempre once caracteres. La columna por la que indexar, y por la que deduplicar, porque el mismo vídeo puede aparecer más de una vez en una ejecución.
- title
- El título del vídeo. Puede llevar espacios al final, así que recórtalo antes de comparar o agrupar por él.
- url
- Un enlace al vídeo. La forma sigue a
video_type: /watch?v=<id> para un vídeo normal y /shorts/<id> para un short. El id siempre está dentro. - channel_title
- El nombre visible del canal. También lleva espacios al final, y puede quedar vacío en resultados que vinieron de una búsqueda por palabra clave.
- channel_id
- El id del canal, siempre empieza por
UC. La forma estable de agrupar por canal: un canal puede cambiarse el nombre y esto no cambiará. También puede quedar vacío en resultados de palabra clave. - views
- El recuento de visualizaciones tal como lo imprime YouTube: una cadena redondeada y abreviada como
5.6K views. No siempre es un recuento de visualizaciones: una sola visualización se lee 1 view, y una retransmisión en directo se lee <n> watching, que son espectadores simultáneos y no reproducciones acumuladas. - views_parsed
- El número. Pese al nombre, este es el recuento exacto y no la cadena mostrada analizada: un vídeo que muestra
4.1M views volvió como 4099999. Esta es la columna por la que sumar, ordenar y comparar; views es para enseñar a una persona. - published
- Cuánto antes de la ejecución se publicó el vídeo, como frase relativa:
9 days ago, 2 weeks ago, 3 months ago. Nunca una fecha absoluta, y nunca presente en un short. Mira la nota de abajo sobre cómo anclarla. - length
- La duración como
m:ss o h:mm:ss. No está presente en un short, ni en una retransmisión en directo. - video_type
- O
short o video, según el tipo de vídeo que elegiste para la ejecución. Una ejecución devuelve uno u otro, así que esta columna es constante dentro de un archivo: está para distinguir dos archivos después. - thumbnail
- Un enlace a la imagen de vista previa. El nombre de archivo varía -
frame0.jpg en shorts, y hqdefault, hq720 y variantes personalizadas en el resto-, así que lee la columna en vez de construir la URL tú. El id del vídeo siempre está dentro.