YouTube Data Tools

Video List Module

This module creates a list of video infos and statistics from one of four sources: the videos uploaded to a specified channel, a playlist, the videos retrieved by a particular search query, or the videos specified by a list of ids.

The script then creates a tabular file where each row is a video. A number of infos and variables are added for each video.

Check the documentation for the video/list (used to get the info for each video) and the search/list (used for the search function) API endpoint for additional information.


Choose a way of making a list:

Channel id:
(channel ids can be found in URLs, e.g.

Playlist id:
(playlist ids can be found in URLs, e.g.

Search query:
(this is passed to the search endpoint, check the "q" parameter here for how to use boolean operators)

optional ISO 639-1 relevance language:

optional ISO 3166-1 alpha-2 region code: (default = US)

(max. 10, one iteration gets 50 items)
limit search to videos published in a specific timeframe (format: yyyy-mm-ddThh:mm:ssZ - timezone: UTC):



make a search for each day of the timeframe (can yield many more videos, use wisely)
Rank by:
search for videos that specify location in their metadata:

point: (latitude/longitude coordinates, e.g. 37.42307,-122.08427)

radius: (radius in m, km, ft, or mi, e.g. 10km)

Manual selection:
(video ids, comma separated)

Output options:

File format:
csv / tab
Co-tag network:
generate a co-tag network (can run out of memory if used with very long video lists)