YouTube.js/docs/API/music.md

Music

YouTube Music class.

API

• Music
  • .getInfo(target)
  • .search(query, filters?)
  • .getHomeFeed()
  • .getExplore()
  • .getLibrary()
  • .getArtist(artist_id)
  • .getAlbum(album_id)
  • .getPlaylist(playlist_id)
  • .getLyrics(video_id)
  • .getUpNext(video_id, automix?)
  • .getRelated(video_id)
  • .getRecap()
  • .getSearchSuggestions(query)

getInfo(target)

Retrieves track info.

Returns: Promise.<TrackInfo>

Param	Type	Description
target	string or MusicTwoRowItem	video id or list item

Methods & Getters

• <info>#getTab(title)

  • Retrieves contents of the given tab.

• <info>#getUpNext(automix?)

  • Retrieves up next.

• <info>#getRelated()

  • Retrieves related content.

• <info>#getLyrics()

  • Retrieves song lyrics.

• <info>#available_tabs

  • Returns available tabs.

search(query, filters?)

Searches on YouTube Music.

Returns: Promise.<Search>

Param	Type	Description
query	string	Search query
filters?	object	Search filters

Methods & Getters

• <search>#getMore(shelf)

  • Equivalent to clicking on the shelf to load more items.

• <search>#getContinuation()

  • Retrieves continuation, only works for individual sections or filtered results.

• <search>#selectFilter(name)

  • Applies given filter to the search.

• <search>#has_continuation

  • Checks if continuation is available.

• <search>#filters

  • Returns available filters.

• <search>#songs

  • Returns songs shelf.

• <search>#videos

  • Returns videos shelf.

• <search>#albums

  • Returns albums shelf.

• <search>#artists

  • Returns artists shelf.

• <search>#playlists

  • Returns songs shelf.

• <search>#page

  • Returns original InnerTube response (sanitized).

getHomeFeed()

Retrieves home feed.

Returns: Promise.<HomeFeed>

Methods & Getters

• <homefeed>#getContinuation()

  • Retrieves continuation, only works for individual sections or filtered results.

• <homefeed>#has_continuation

  • Checks if continuation is available.

• <homefeed>#page

  • Returns original InnerTube response (sanitized).

getExplore()

Retrieves “Explore” feed.

Returns: Promise.<Explore>

Methods & Getters

• <explore>#page
  • Returns original InnerTube response (sanitized).

getLibrary()

Retrieves library.

Returns: Promise.<Library>

Methods & Getters

• <library>#getPlaylists(args?)

  • Retrieves the library's playlists.

• <library>#getAlbums(args?)

  • Retrieves the library's albums.

• <library>#getArtists(args?)

  • Retrieves the library's artists.

• <library>#getSongs(args?)

  • Retrieves the library's songs.

• <library>#getRecentActivity(args)

  • Retrieves recent activity.

getArtist(artist_id)

Retrieves artist's info & content.

Returns: Promise.<Artist>

Param	Type	Description
artist_id	string	Artist id

Methods & Getters

• <artist>#page
  • Returns original InnerTube response (sanitized).

getAlbum(album_id)

Retrieves given album.

Returns: Promise.<Album>

Param	Type	Description
album_id	string	Album id

Methods & Getters

• <album>#page
  • Returns original InnerTube response (sanitized).

getPlaylist(playlist_id)

Retrieves given playlist.

Returns: Promise.<Playlist>

Param	Type	Description
playlist_id	string	Playlist id

Methods & Getters

• <playlist>#getRelated()

  • Retrieves related playlists.

• <playlist>#getSuggestions()

  • Retrieves playlist suggestions.

• <playlist>#getContinuation()

  • Retrieves continuation.

• <playlist>#has_continuation

  • Checks if continuation is available.

• <playlist>#page

  • Returns original InnerTube response (sanitized).

getLyrics(video_id)

Retrieves song lyrics.

Returns: Promise.<MusicDescriptionShelf | undefined>

Param	Type	Description
video_id	string	Video id

getUpNext(video_id, automix?)

Retrieves up next content.

Returns: Promise.<PlaylistPanel>

Param	Type	Description
video_id	string	Video id
automix?	boolean	if automix should be fetched

getRelated(video_id)

Retrieves related content.

Returns: Promise.<Array.<MusicCarouselShelf | MusicDescriptionShelf>>

Param	Type	Description
video_id	string	Video id

getRecap()

Retrieves your YouTube Music recap.

Returns: Promise.<Recap>

Methods & Getters

• <recap>#getPlaylist()

  • Retrieves recap playlist.

• <recap>#page

  • Returns original InnerTube response (sanitized).

getSearchSuggestions(query)

Retrieves search suggestions.

Returns: Promise.<Array.<SearchSuggestion | HistorySuggestion>>

Param	Type	Description
query	string	Search query