Browse

Browse

new Browse(spotify)

Creates a new Browse instance
Source:
Parameters:
Name Type Description
spotify Spotify

Methods

getCategories(country, locale, limit)

Source:
Parameters:
Name Type Default Description
country String US an ISO 3166-1 alpha-2 country code.
locale String en-US an ISO 639-1 language code and an ISO 3166-1 alpha-2 country code; Default: en_US
limit Number 20 maximum number of items to return; default: 20, min: 1, max: 50
Returns:
array of categories https://developer.spotify.com/documentation/web-api/reference/browse/get-list-categories/

getCategory(id, country, localean)

Get a single category used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).
Source:
Parameters:
Name Type Default Description
id String Category id
country String US an ISO 3166-1 alpha-2 country code.
localean String ISO 639-1 language code and an ISO 3166-1 alpha-2 country code; Default: en_US
Returns:
Category Object https://developer.spotify.com/documentation/web-api/reference/browse/get-category/

getCategoryPlaylists(id, country, limit)

Get a list of Spotify playlists tagged with a particular category.
Source:
Parameters:
Name Type Default Description
id String category id
country String US an ISO 3166-1 alpha-2 country code.
limit Number 20 maximum number of items to return; default: 20, min: 1, max: 50
Returns:
array of playlist objects https://developer.spotify.com/documentation/web-api/reference/browse/get-categorys-playlists/

getFeaturedPlaylists(locale, country, limit)

Get a list of Spotify featured playlists (shown, for example, on a Spotify player’s ‘Browse’ tab).
Source:
Parameters:
Name Type Default Description
locale String en_US an ISO 639-1 language code and an ISO 3166-1 alpha-2 country code; Default: en_US
country String US an ISO 3166-1 alpha-2 country code.
limit Number 20 maximum number of items to return; default: 20, min: 1, max: 50
Returns:
array of playlists https://developer.spotify.com/documentation/web-api/reference/browse/get-list-featured-playlists/

getNewReleases(country, limit)

Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).
Source:
Parameters:
Name Type Default Description
country String US an ISO 3166-1 alpha-2 country code.
limit Number 20 maximum number of items to return; Default: 20, Min: 1, Max: 50
Returns:
array of albums https://developer.spotify.com/documentation/web-api/reference/browse/get-list-new-releases/

getRecommendations(limit, market, max, min, seedArtists, seedGenres, seedTracks, target)

Recommendations are generated based on the available information for a given seed entity and matched against similar artists and tracks. If there is sufficient information about the provided seeds, a list of tracks will be returned together with pool size details.
Source:
Parameters:
Name Type Default Description
limit Number 20 maximum number of items to return; default: 20, min: 1, max: 50
market String an ISO 3166-1 alpha-2 country code.
max Array For each tunable track attribute, a hard ceiling on the selected track attribute’s value can be provided. See tunable track attributes below for the list of available options. For example, max_instrumentalness=0.35 would filter out most tracks that are likely to be instrumental.
min Array For each tunable track attribute, a hard floor on the selected track attribute’s value can be provided. See tunable track attributes below for the list of available options. For example, min_tempo=140 would restrict results to only those tracks with a tempo of greater than 140 beats per minute.
seedArtists Array array of artist ids; max 5 for all seed values
seedGenres String array of genres; max 5 for all seed values; See https://developer.spotify.com/documentation/web-api/reference/browse/get-recommendations/#available-genre-seeds
seedTracks Array array of track ids; max 5 for all seed values
target Array For each of the tunable track attributes (below) a target value may be provided. Tracks with the attribute values nearest to the target values will be preferred. For example, you might request target_energy=0.6 and target_danceability=0.8. All target values will be weighed equally in ranking results.
Returns:
Array of tracks https://developer.spotify.com/documentation/web-api/reference/browse/get-recommendations/