ytmusic-api

YouTube Music API which comes with TypeScript support

Initialization

Import YTMusic from the npm package

// TypeScript
import YTMusic from "ytmusic-api"

// JavaScript
const YTMusic = require("ytmusic-api")

Create an instance of the class YTMusic. Then, call the initialize() to initialize the API before using the API anywhere

const ytmusic = new YTMusic()
ytmusic.initialize().then(() => {
    // Use API here
})

Class Methods

getSearchSuggestions

This function takes in the following parameters

The function returns a Promise<string[]> which are the suggestion results

ytmusic.getSearchSuggestions("Lilac").then(res => {
    console.log(res)
})

search

This function takes in the following parameters

The function when nothing is passed as the category returns a Promise<SearchResult[]> which are the search results of all categories

ytmusic.search("Lilac").then(results => {
    console.log(results)
})

search (category = "SONG")

When you pass in "SONG" as the category,

The function returns a Promise<SongDetailed[]> which are the song results

ytmusic.search("Lilac", "SONG").then(songs => {
    console.log(songs)
})

search (category = "VIDEO")

When you pass in "VIDEO" as the category,

The function returns a Promise<VideoDetailed[]> which are the video results

ytmusic.search("Lilac", "VIDEO").then(videos => {
    console.log(videos)
})

search (category = "ARTIST")

When you pass in "ARTIST" as the category

The function returns a Promise<ArtistDetailed[]> which are the artist results

ytmusic.search("Lilac", "ARTIST").then(artists => {
    console.log(artists)
})

search (category = "ALBUM")

When you pass in "ALBUM" as the category,

The function returns a Promise<AlbumDetailed[]> which are the album results

ytmusic.search("Lilac", "ALBUM").then(albums => {
    console.log(albums)
})

search (category = "PLAYLIST")

When you pass in "PLAYLIST" as the category,

The function returns a Promise<PlaylistFull[]> which are the playlist results

ytmusic.search("Lilac", "PLAYLIST").then(playlists => {
    console.log(playlists)
})

getSong

This function takes in the following parameters

The function returns a Promise<SongFull> which is the information about the song

ytmusic.getSong("v7bnOxV4jAc").then(song => {
    console.log(song)
})

getVideo

This function takes in the following parameters

The function returns a Promise<VideoFull> which is the information about the video

ytmusic.getVideo("v7bnOxV4jAc").then(video => {
    console.log(video)
})

getArtist

This function takes in the following parameters

The function returns a Promise<ArtistFull> which is the information about the artist

ytmusic.getArtist("UCTUR0sVEkD8T5MlSHqgaI_Q").then(artist => {
    console.log(artist)
})

getArtistSongs

This function takes in the following parameters

The function returns a Promise<SongDetailed[]> which is the information about all the artist's songs

ytmusic.getArtistSongs("UCTUR0sVEkD8T5MlSHqgaI_Q").then(artistSongs => {
    console.log(artistSongs)
})

getArtistAlbums

This function takes in the following parameters

The function returns a Promise<AlbumDetailed[]> which is the information about all the artist's albums

ytmusic.getArtistAlbums("UCTUR0sVEkD8T5MlSHqgaI_Q").then(artistAlbums => {
    console.log(artistAlbums)
})

getAlbum

This function takes in the following parameters

The function returns a Promise<AlbumFull> which is the information about the album

ytmusic.getAlbum("MPREb_iG5q5DIdhdA").then(album => {
    console.log(album)
})

getPlaylist

This function takes in the following parameters

The function returns a Promise<PlaylistFull> which is the information about the playlist (without the videos)

ytmusic.getPlaylist("OLAK5uy_nRb467jR73IXKybwzw22_rTYIJ808x4Yc").then(playlist => {
    console.log(playlist)
})

getPlaylistVideos

This function takes in the following parameters

The function returns a Promise<Omit<VideoDetailed, "views">[]> which is the information about the videos without the view count

ytmusic.getPlaylistVideos("OLAK5uy_nRb467jR73IXKybwzw22_rTYIJ808x4Yc").then(playlistVideos => {
    console.log(playlistVideos)
})

Data Types

ThumbnailFull

SongDetailed

SongFull

VideoDetailed

VideoFull

ArtistBasic

ArtistDetailed

ArtistFull

AlbumBasic

AlbumDetailed

AlbumFull

PlaylistFull

SearchResult

SongDetailed or VideoDetailed or ArtistDetailed or AlbumDetailed or PlaylistFull