YouTube.js/docs/API/music.md

Music

YouTube Music class.

API

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

getInfo(video_id)

Retrieves track info.

Returns: Promise.<TrackInfo>

Param	Type	Description
video_id	string	Video id

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>

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.<{ text: string; footer: object; }>

Param	Type	Description
video_id	string	Video id

getUpNext(video_id)

Retrieves up next content.

Returns: Promise.<PlaylistPanel>

Param	Type	Description
video_id	string	Video id

getRelated(video_id)

Retrieves related content.

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

Param	Type	Description
video_id	string	Video id

getSearchSuggestions(query)

Retrieves search suggestions.

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

Param	Type	Description
query	string	Search query