ytmusicapi: Unofficial API for YouTube Music

The purpose of this library is to automate interactions with YouTube Music, such as retrieving your library content or creating large playlists.

This project is not supported nor endorsed by Google


  • Library management: list, create, delete, and modify playlists and playlist items
  • Search: Search for songs on YouTube Music
  • Uploads: Upload songs, list uploaded songs and delete uploaded songs

Usage Example

For a complete documentation of available functions, refer to the Reference

from ytmusicapi import YTMusic

ytmusic = YTMusic('headers_auth.json')
playlistId = ytmusic.create_playlist("test", "test description")
search_results ="Oasis Wonderwall")
ytmusic.add_playlist_items(playlistId, [search_results[0]['videoId']])