youtube-search-fork

youtube_search-fork

This fork adds the ability to search for channels, latest content of a channel, channel information, channel vidoes, and adds videos published date and channelId. It works scrapping the Youtube pages.

• Search on youtube avoiding the use their heavily rate-limited API.
• No need for Google account.
• No limits.
• Reasonably fast.

Installation

pip install youtube-search-fork

Example Usage

For a basic search (and all of the current functionality), you can use the search tool as follows:

• Get Youtube channel videos and channel info and parse it to JSON.

from youtube_search import YoutubeSearch

videos = YoutubeSearch('search terms', max_results=10).videos_to_json()
channels = YoutubeSearch('search terms', max_results=10).channels_to_json()

This will get all the videos from the search query into videos and all the found channels into channels and parse it in a JSON format.

• Get Youtube search videos and channels and parse it to a dict.

from youtube_search import YoutubeSearch

videos = YoutubeSearch('search terms', max_results=10).videos_to_dict()
channels = YoutubeSearch('search terms', max_results=10).channels_to_dict()

This will get all the videos from the search query into videos and all the found channels into channels and parse it in a Python dictionary.

• Get a specific channel info and videos:

from youtube_search import YoutubeSearch
data = YoutubeSearch.channelInfo(channel_id)


channelInfo = data[0]
channelVideoList = data[1]

This will get all the videos and their data from the specified channel (channelID needed) into channelVideoList and the channel data (suscribers, username, etc) into channelVideoList.

• You can request only the channel info:

from youtube_search import YoutubeSearch

# The second (and optional) parameter is `includeVideos`. By default is se to True.
channelOnlyData = YoutubeSearch.channelInfo(channel_id, False)
channelInfo = data[0]

Same as before, but just the channel data.

Formats

• Channel info format: {'id': 'UCjr2bPAyPV.....8Q', 'name': 'Channel Name', 'avatar': 'https://yt3.ggpht.com/a/AATXAJzuPoT_2M54dus-P2qXgnbY0MPxbkzvwv3muxQn=s176-c-k-c0x00ffffff-no-rj', 'subCount': '24K'}

• Video list format: [{'videoTitle': 'Video title goes here', 'id': 'video_id_here', 'channelName': 'Channel Name', 'timeStamp': '17 hours ago', 'views': '13,661 views', 'videoThumb': 'https://i.ytimg.com/vi/3eC4Hp4MNBA/hqdefault.jpg?sqp=-oaymwEiCKgBEF5IWvKriqkDFQgBFQAAAAAYASUAAMhCPQCAokN4AQ==&rs=AOn4....5o_2mazZd40g_xc_3917M5w', 'channelUrl': '/channel/UCjr2bPA.......gT3W8Q'}, {...}, {...}, ...]