Music

This API provides deep and powerful tools for searching lyrics, artists or albums. Unlike other APIs it can also search by lyrics and does not need separate artist and song name entries.

Get Lyrics for a song

ksoft.lyrics.get(song, options);
Usage
Examples
Usage

Parameter

Type

song

String

options.textOnly

Boolean

Success: Returns Track

Not Found: Throws Error

Examples
ksoft.lyrics.get('Billie Eyelash - Bald Guy');
ksoft.lyrics.get('Is this the real life? Is this just fantasy?',
{ textOnly: true });

Search lyrics

ksoft.lyrics.search(query, options);
Usage
Examples
Usage

Parameter

Type

query

String

options.limit

Number

options.textOnly

Boolean

Success: Returns Array<Track>

Not Found: Throws Error

Examples
ksoft.lyrics.search('Billie Eyelash', { limit: 5 })
.catch(err => console.log(err.message));
ksoft.lyrics.search("I'm the baaaaaad guyyyy (duh)", { textOnly: true });

Get Artist/Track/Album by ID

ksoft.music.artist(id);
ksoft.music.track(id);
ksoft.music.album(id);
Usage
Examples
Usage

Parameter

Type

id

String

Success: Returns Artist/Track/Album

Not Found: Throws Error

Examples
ksoft.music.artist('28333');
ksoft.music.track('628942');
ksoft.music.album('88287');

Get Music Recommendations (paid)

ksoft.music.recommendations(provider, tracks, token, options);
Usage
Example
Usage

Parameter

Type

provider

String: 'spotify' | 'youtube' | 'youtube_ids' | 'youtube_titles'

tracks

Array<String> (track IDs or titles depending on provider)

token

String (YouTube API token)

options.limit

Number

Success: Returns Array<Suggestion>

Example
ksoft.music.recommendations('youtube_titles', [
'Luis - Des',
'Luis - Pa',
'Fonsi - Ci',
'Fonsi - To'
], 'you-wish-i-put-one-here', { limit: 3 });