A Python wrapper around for YouTube Data API.
Project description
Python YouTube
A Python wrapper around for YouTube Data API V3.
THANKS
This project structure is base on Python-Twitter.
Thanks a lot for Python-Twitter Developers.
Introduction
Library provides a service to easy use YouTube Data API V3.
Documentation
You can view the latest python-youtube documentation at: https://python-youtube.readthedocs.io/en/latest/.
Also view the full YouTube DATA API docs at: https://google-developers.appspot.com/youtube/v3/docs/.
Installing
You can install this lib from pypi:
$pip install --upgrade python-youtube ✨🍰✨
Using
The API is exposed via the pyyoutube.Api class.
To create an instance of the pyyoutube.Api with two different methods. Use only api key or provide google client id and key. Now only for api key:
In [1]: from pyyoutube import Api In [2]: api = Api(api_key='your api key')
To fetch one youtube channel’s data:
In [3]: res = api.get_channel_info(channel_name='GoogleDevelopers') In [4]: res Out[4]: [Channel(id=UC_x5XG1OV2P6uZZ5FSM9Ttw,kind=youtube#channel)]
To fetch youtube channel’s playlists:
In [5]: res = api.get_playlist(channel_id='UC_x5XG1OV2P6uZZ5FSM9Ttw') In [6]: res Out[6]: ([Playlist(id=PLOU2XLYxmsILRdsoscDOuCp-6r3LgKtrv,kind=youtube#playlist), Playlist(id=PLOU2XLYxmsIJXsH2htG1g0NUjHGq62Q7i,kind=youtube#playlist), Playlist(id=PLOU2XLYxmsIJJVnHWmd1qfr0Caq4VZCu4,kind=youtube#playlist), Playlist(id=PLOU2XLYxmsIKW-llcbcFdpR9RjCfYHZaV,kind=youtube#playlist), Playlist(id=PLOU2XLYxmsIIOSO0eWuj-6yQmdakarUzN,kind=youtube#playlist)], {'totalResults': 416, 'resultsPerPage': 5})
To fetch one playlist’s items:
In [8]: res = api.get_playlist_item(playlist_id='PLOU2XLYxmsILRdsoscDOuCp-6r3LgKtrv') In [9]: res Out[9]: ([PlaylistItem(id=UExPVTJYTFl4bXNJTFJkc29zY0RPdUNwLTZyM0xnS3Rydi41NkI0NEY2RDEwNTU3Q0M2,kind=youtube#playlistItem), PlaylistItem(id=UExPVTJYTFl4bXNJTFJkc29zY0RPdUNwLTZyM0xnS3Rydi4yODlGNEE0NkRGMEEzMEQy,kind=youtube#playlistItem), PlaylistItem(id=UExPVTJYTFl4bXNJTFJkc29zY0RPdUNwLTZyM0xnS3Rydi4wMTcyMDhGQUE4NTIzM0Y5,kind=youtube#playlistItem), PlaylistItem(id=UExPVTJYTFl4bXNJTFJkc29zY0RPdUNwLTZyM0xnS3Rydi41MjE1MkI0OTQ2QzJGNzNG,kind=youtube#playlistItem), PlaylistItem(id=UExPVTJYTFl4bXNJTFJkc29zY0RPdUNwLTZyM0xnS3Rydi4wOTA3OTZBNzVEMTUzOTMy,kind=youtube#playlistItem)], {'totalResults': 13, 'resultsPerPage': 5}) In [10]: res[0][1].snippet.resourceId Out[10]: ResourceId(videoId=pXoLrNNLPHc,kind=youtube#video)
To fetch one youtube video’s data:
In [12]: res = api.get_video_by_id(video_id='pXoLrNNLPHc') In [13]: res Out[13]: [Video(id=pXoLrNNLPHc,kind=youtube#video)]
To fetch many youtube video’s data:
In [14]: res = api.get_video_by_id(video_id='pXoLrNNLPHc,21BbGGGrq9s') In [15]: res Out[15]: [Video(id=pXoLrNNLPHc,kind=youtube#video), Video(id=21BbGGGrq9s,kind=youtube#video)]
Fetch comment thread info. You can use multi different parameter. If you want to get the channel and the channel’s videos comment threads. You can provide target channel id with all_to_channel_id parameter. Like follows:
In [16]: resp = api.get_comment_threads(all_to_channel_id='UC_x5XG1OV2P6uZZ5FSM9Ttw', count=4) In [17]: resp Out[17]: [CommentTread(id=Ugw1xBqKuaHKPfZR38h4AaABAg,kind=youtube#commentThread), CommentTread(id=Ugz-p7OFo3PwLQ_K1TJ4AaABAg,kind=youtube#commentThread), CommentTread(id=Ugy3iS0auqxlIP6eqZh4AaABAg,kind=youtube#commentThread), CommentTread(id=UgyeUVq35jr01dmURqZ4AaABAg,kind=youtube#commentThread)]
If you want to just get a channel comment threads. use channel_id instead of all_to_channel_id. Like follows:
In [18]: resp = api.get_comment_threads(channel_id='UC_x5XG1OV2P6uZZ5FSM9Ttw', count=4)
If you want to get a video comment threads. You can provide target video id with video_id. Like follows:
In [19]: resp = api.get_comment_threads(video_id='D-lhorsDlUQ', count=2) In [20]: resp Out[20]: [CommentTread(id=UgydxWWoeA7F1OdqypJ4AaABAg,kind=youtube#commentThread), CommentTread(id=UgxKREWxIgDrw8w2e_Z4AaABAg,kind=youtube#commentThread)]
If you want get comment thread detail info. You can provide comment thread id or comma-separated id list. Like follows:
In [21]: resp = api.get_comment_thread_info(comment_thread_id='Ugz097FRhsQy5CVhAjp4AaABAg,UgzhytyP79_PwaDd4UB4AaABAg') In [22]: resp Out[22]: [CommentTread(id=Ugz097FRhsQy5CVhAjp4AaABAg,kind=youtube#commentThread), CommentTread(id=UgzhytyP79_PwaDd4UB4AaABAg,kind=youtube#commentThread)]
Fetch comments info. You can use multi different parameter. If you want to get top level’s comment’s replies. Like follows:
In [23]: resp = api.get_comments_by_parent(parent_id='UgwYjZXfNCUTKPq9CZp4AaABAg') In [24]: resp Out[24]: [Comment(id=UgwYjZXfNCUTKPq9CZp4AaABAg.8yxhlQJogG18yz_cXK9Kcj,kind=youtube#comment)]
If want get comment detail info. You can provide comment id or comma-separated id list. Like follows:
In [25]: resp = api.get_comment_info(comment_id='UgxKREWxIgDrw8w2e_Z4AaABAg,UgyrVQaFfEdvaSzstj14AaABAg') In [26]: resp Out[26]: [Comment(id=UgxKREWxIgDrw8w2e_Z4AaABAg,kind=youtube#comment), Comment(id=UgyrVQaFfEdvaSzstj14AaABAg,kind=youtube#comment)]
TODO
Now this has follows api.
OAuth Demo
Channel Info
Playlist Info
PlaylistItem Info
Video Info
Comment Thread Info
Comment Info
Video Categories Info
Guide Categories Info
Doing
Search
Subscriptions
Captions
Activities
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for python_youtube-0.4.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | df222e3936620d3f5afed6169f1ff7e2e938898fb45728a827efb56c324a5ca4 |
|
MD5 | 63dcaee682dc55c7c89e82ae628e64e7 |
|
BLAKE2b-256 | 2e7176df45110b627615c59d8b6a8c0bd6a4f7e152a7ae603fdb79365ea13299 |