Python asynchronous wrapper for youtube data api v3.
Project description
ytpy
Python wrapper for youtube data api v3. Simple asynchronous wrapper to get youtube video or playlist data. The purpose of this project is to make it easier for developers to extract data from YouTube.
Requirements
- Python 3.x
- Get Google API' Credential 'API KEY'
Dependencies
- urllib
For examples & tests
- asyncio
- aiohttp
Install
pip install --upgrade ytpy
Run Test Code
- On project root. run command:
python ytpy/test/test_import.py
Asynchronous Youtube Service Object
Use AioYoutubeService
object for asynchronous tasks.
You can pass your api key on dev_key
param when building the object or just set your api key on environment variable named DEVELOPER_KEY
and AioYoutubeService
object will get it for you.
import aiohttp
session = aiohttp.ClientSession()
# will get your api key from environment (named DEVELOPER_KEY).
ayt = AioYoutubeService(session)
# you can also pass it on dev_key param.
ayt = AioYoutubeService(session, dev_key='replace me')
session.close()
Basic Usage: Search Video by Search Key
https://developers.google.com/youtube/v3/docs/search
params:
q
, string. Search key. default: empty string.part
, string. Valid parts: snippet, contentDetails, player, statistics, status. default: snippet.type
, string. Valid types: video, playlist, channel.
Example Search
method
async def main():
session = aiohttp.ClientSession()
ayt = AioYoutubeService(session, dev_key='<replace-me>')
# test search
results = await ayt.search(q="kpop song", search_type="video", max_results=3)
print(results['items'][0])
session.close()
Example Asynchronous
Check examples for the full code example
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
ytpy-2020.10.9.tar.gz
(4.6 kB
view hashes)