ytmusicapi: Unofficial API for YouTube Music
A work-in-progress API that emulates web requests from the YouTube Music web client.
Currently you need to extract your authentication data from your web browser and provide it through a file for it to work.
Features
Browsing:
- get artist information and releases (songs, videos, albums, singles)
- get albums
- search (including all filters)
Library management:
- get library contents: playlists, songs, artists, albums and subscriptions
- add/remove library content: rate songs, albums and playlists, subscribe/unsubscribe artists
Playlists:
- create, delete, and modify playlists
- get playlist contents, add/remove tracks
Uploads:
- Upload songs and remove them again
- List uploaded songs, artists and albums
Usage
from ytmusicapi import YTMusic
ytmusic = YTMusic('headers_auth.json')
playlistId = ytmusic.create_playlist("test", "test description")
search_results = ytmusic.search("Oasis Wonderwall")
ytmusic.add_playlist_items(playlistId, [search_results[0]['videoId']])The tests are also a great source of usage examples.
Requirements
- Python 3.5 or higher - https://www.python.org
Setup and Usage
See the Documentation for detailed instructions
Contributing
Pull requests are welcome. There are still some features that are not yet implemented.