Watch

Methods

# (async) getWatchPlaylist(videoId, playlistId, limit, params)

Get a watch list of tracks. This watch playlist appears when you press play on a track in YouTube Music. Please note that the `INDIFFERENT` likeStatus of tracks returned by this endpoint may be either `INDIFFERENT` or `DISLIKE`, due to ambiguous data returned by YouTube Music.
Parameters:
Name Type Description
videoId string videoId of the played video
playlistId string playlistId of the played playlist or album
limit number minimum number of watch playlist items to return
params only used internally by `getWatchPlaylistShuffle`
Returns:
List of watch playlist items. The counterpart key is optional and only appears if a song has a corresponding video counterpart (UI song/video switcher).
Example
{
  "tracks": [
     {
       "videoId": "9mWr4c_ig54",
       "title": "Foolish Of Me (feat. Jonathan Mendelsohn)",
       "length": "3:07",
       "thumbnail": [
         {
           "url": "https://lh3.googleusercontent.com/ulK2YaLtOW0PzcN7ufltG6e4ae3WZ9Bvg8CCwhe6LOccu1lCKxJy2r5AsYrsHeMBSLrGJCNpJqXgwczk=w60-h60-l90-rj",
           "width": 60,
           "height": 60
         }...
       ],
       "feedbackTokens": {
         "add": "AB9zfpIGg9XN4u2iJ...",
         "remove": "AB9zfpJdzWLcdZtC..."
       },
       "likeStatus": "INDIFFERENT",
       "artists": [
         {
           "name": "Seven Lions",
           "id": "UCYd2yzYRx7b9FYnBSlbnknA"
         },
         {
           "name": "Jason Ross",
           "id": "UCVCD9Iwnqn2ipN9JIF6B-nA"
         },
         {
           "name": "Crystal Skies",
           "id": "UCTJZESxeZ0J_M7JXyFUVmvA"
         }
       ],
       "album": {
         "name": "Foolish Of Me",
         "id": "MPREb_C8aRK1qmsDJ"
       },
       "year": "2020",
       "counterpart": {
         "videoId": "E0S4W34zFMA",
         "title": "Foolish Of Me [ABGT404] (feat. Jonathan Mendelsohn)",
         "length": "3:07",
         "thumbnail": [...],
         "feedbackTokens": null,
         "likeStatus": "LIKE",
         "artists": [
           {
             "name": "Jason Ross",
             "id": null
           },
           {
             "name": "Seven Lions",
             "id": null
           },
           {
             "name": "Crystal Skies",
             "id": null
           }
         ],
         "views": "6.6K"
       }
     },...
  ],
  "playlistId": "RDAMVM4y33h81phKU",
  "lyrics": "MPLYt_HNNclO0Ddoc-17"
}

# (async) getWatchPlaylistShuffle(videoId, playlistId, limit)

Shuffle any playlist
Parameters:
Name Type Description
videoId string Optional video id of the first video in the shuffled playlist
playlistId string Playlist id
limit number The number of watch playlist items to return @default 50
Returns:
A list of watch playlist items