sigma67/ytmusicapi 0.16.0

v0.16.0

on GitHub

Features ✨

• get_album_browse_id: get an album's browseId based on it's audioPlaylistId (OLAK...). This is based on the redirect that happens when you open a link in YouTube Music with an audioPlaylistId

Changes ⚒

• BREAKING get_album endpoint has changed for some users due to an ongoing YouTube beta (#173). With this release, get_album will always work, but the format of the data might look different from the documentation if you have the update. Please check if this applies to your account. The documentation will be updated for the new format once the beta is released to all users. For reference, an example of the new format is provided below. A big thanks to @jake-g for providing access to his account to test this update ahead of time.

Fixes 🐞

• search: fixed a crash if the playlist author was missing for a playlist
• search: for songs with artists without browseId, these artists are now also returned in the result. This also applies to get_watch_playlist
• get_artist_albums: fixed an exception for singles missing a release year (#188, thanks @grray )
• get_artist: fix crash if related artist is missing subscriber number
• fixed feedbackTokens, which were incorrectly None when a song was already in the library. Now the correct tokens are returned regardless of the current library status

New get_album format

{
  "title": "Revival",
  "type": "Album",
  "thumbnails": [
    {
      "url": "https://lh3.googleusercontent.com/b-euORTq-_MSzc3SyI0QOjLqnCBJbWuMmH1YlyJKAVvJfOpPqv3bFH-KSDoQwV9e8Xey1X2NRo9xZ2U=w60-h60-l90-rj",
      "width": 60,
      "height": 60
    }
  ],
  "description": "Revival is the ninth studio ...",
  "artists": [
    {
      "name": "Eminem",
      "id": "UCedvOgsKFzcK3hA5taf3KoQ"
    }
  ],
  "year": "2017",
  "trackCount": 19,
  "duration": "1 hour, 17 minutes",
  "audioPlaylistId": "OLAK5uy_nMr9h2VlS-2PULNz3M3XVXQj_P3C2bqaY",
  "tracks": [
    {
      "videoId": "iKLU7z_xdYQ",
      "title": "Walk On Water (feat. Beyoncé)",
      "artists": [
        {
          "name": "Eminem",
          "id": "UCedvOgsKFzcK3hA5taf3KoQ"
        }
      ],
      "album": null,
      "likeStatus": "INDIFFERENT",
      "thumbnails": null,
      "isAvailable": true,
      "isExplicit": true,
      "duration": "5:03",
      "feedbackTokens": {
        "add": "AB9zfpJC...",
        "remove": "AB9zfpJT..."
      }
    }
  ]
}