Description

YoutubeChannelVideosFinder is a small utility script that goes out and find all video links of a given Youtube channel. Youtube's data API has a limit of 500 search results. This script splits the search in multiple smaller operations, making it possible to get all video links while respecting the rules :)

Usage

This script provides multiple arguments that can be used to customize its behavior.

Only two arguments are mandatory:

• -k or --api-key: mandatory to access Youtube's data API. You can get one from there: https://console.developers.google.com
• -c or --channel: otherwise the script cannot find many videos, can it? :)

To display the full list of supported arguments, use '-h' or '--help'.

$ py ./youtubeChannelVideosFinder.py --help
usage: youtubeChannelVideosFinder.py [-h] -k APIKEY -c CHANNEL
									 [-o OUTPUTFILEPATH] [-x DATEFROM]
									 [-y DATETO] [-i INTERVAL] [-q | -v | -d]
									 [-l LOGFILEPATH] [--version]

This program finds all videos in a given Youtube channel

optional arguments:
  -h, --help            show this help message and exit
  -k APIKEY, --api-key APIKEY
						Google Data API key to use. You can get one here:
						https://console.developers.google.com
  -c CHANNEL, --channel CHANNEL
						Youtube channel to get videos from
  -o OUTPUTFILEPATH, --output-file-path OUTPUTFILEPATH
						File to write found video links to (content replaced
						each time). If this option is not specified, the links
						are sent to the standard output
  -x DATEFROM, --date-from DATEFROM
						Videos published after this date will not be retrieved
						(expected format: yyyy-mm-dd). If not specified, the
						current date is taken
  -y DATETO, --date-to DATETO
						Videos published before this date will not be
						retrieved (expected format: yyyy-mm-dd). If not
						specified, we go back one month (related to -b /
						--date-from)
  -i INTERVAL, --interval INTERVAL
						Longest period of time (in days) to retrieve videos at
						a time for. Since the Youtube API only permits to
						retrieve 500 results, the interval cannot be too big,
						otherwise we might hit the limit. Default: 30 days
  -q, --quiet           Only print out results.. or fatal errors
  -v, --verbose         Print out detailed information during execution (e.g.,
						invoked URLs, ...)
  -d, --debug           Print out all the gory details
  -l LOGFILEPATH, --log-file-path LOGFILEPATH
						File to write the logs to (content replaced each
						time). If this option is not specified, the logs are
						sent to the standard output (according to the
						verbosity level)
  --version             show program's version number and exit

Example

Retrieve all videos in the 'martyzsongs' Youtube channel that were published between 2014-01-01 and 2014-06-15. Once found, put the links in a file called 'result.txt'. Also, create a log file containing all the gory details of what the script has done:

$ py ./youtubeChannelVideosFinder.py 
-k ...  # the API key
-c martyzsongs # the channel name 
--date-from 2014-06-15 # last published videos we care about
--date-to 2014-01-01 # oldest published videos we care about
--log-file-path awesome.log # generate a log file
--output-file-path result.txt # put generated links in that file
-d # debug -> tell everything you're doing