disclaimer

the point of this package is NOT to provide some sort of "clean" API for spotify searching. maybe in the future.

the point of this package is to provide a wrapper for spotify's complex API. they are constantly changing parameters and endpoints. it's actually kind of annoying.

that being said, as of searchtify 2.0, it is typed! any modern IDE should give you suggestions that come directly from the API.

usage

usage is relatively simple:

import Spotify from 'searchtify';

const spotify = new Spotify();

const search = await spotify.search('Blinding Lights');
console.log(search.tracksV2.items[0].item.data);

and its album:

// uri format: spotify:album:4yP0hdKOZPNshxUOjY0cZj
const album = await spotify.getAlbum(search.tracksV2.items[0].item.data.albumOfTrack.uri);
console.log(album);

or, for example, an artist:

// uri format: spotify:artist:1Xyo4u8uXC1ZmMpatF05PJ (my goat the weeknd)
const artist = await spotify.getArtist(search.tracksV2.items[0].item.data.artists.items[0].uri);
console.log(artist);

you can limit searches to X number of things PER CATEGORY, which in testing notably does not make any impact on response times:

const search2 = await spotify.search('Hurry Up Tomorrow', { limit: 25 });
console.log(search2.tracksV2.items);

that would return 25 albums, 25 songs, etc

notable parameters include:

• limit - number - the limit of results for each items array
• offset - number - the offset to start at
• numberOfTopResults - number - the number of items in topResultsV2

if there's something you need from here, enable it as part of the search parameters

you can also search for the things on the homepage:

const popular = await spotify.getPopular();
console.log(popular[0].data.title.translatedBaseText + ':');
console.log(popular[0].sectionItems.items[0].content.data);

the structure of the response is the homepage categories and data going down.

getPopular accepts one argument, which is a timezone in the format of "America/New_York".

it defaults to the user's timezone.

you can set a custom user agent using setUserAgent:

spotify.setUserAgent('putting something like this in the useragent will probably flag your IP');

credits

the secrets directory of this repository is code created by Thereallo1026 (repository deleted) the original proof of concept was created by Michal Szymanski the types come from NuclearPlayer, which was created by nukeop

thanks to all of you; y'all rock!