Package de.sonallux.spotify.api.apis

Class BrowseApi

java.lang.Object

de.sonallux.spotify.api.apis.BrowseApi

public class BrowseApi
extends Object

Browse API

Constructor Summary

Constructors

Constructor	Description
BrowseApi()

Method Summary

Modifier and Type	Method	Description
GetCategoriesRequest	getCategories()	Get All Categories
GetCategoriesPlaylistsRequest	getCategoriesPlaylists(String categoryId)	Get a Category's Playlists
GetCategoryRequest	getCategory(String categoryId)	Get a Category
GetFeaturedPlaylistsRequest	getFeaturedPlaylists()	Get All Featured Playlists
GetNewReleasesRequest	getNewReleases()	Get All New Releases
GetRecommendationGenresRequest	getRecommendationGenres()	Get Recommendation Genres
GetRecommendationsRequest	getRecommendations(String seedArtists, String seedGenres, String seedTracks)	Get Recommendations

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BrowseApi

public BrowseApi()

Method Detail

getCategoriesPlaylists

public GetCategoriesPlaylistsRequest getCategoriesPlaylists(String categoryId)

Get a Category's Playlists

Get a list of Spotify playlists tagged with a particular category.

Parameters:

categoryId -

The Spotify category ID for the category.

Returns:

a GetCategoriesPlaylistsRequest object to build and execute the request

getCategory

public GetCategoryRequest getCategory(String categoryId)

Get a Category

Get a single category used to tag items in Spotify (on, for example, the Spotify player's "Browse" tab).

Parameters:

categoryId -

The Spotify category ID for the category.

Returns:

a GetCategoryRequest object to build and execute the request

getCategories

public GetCategoriesRequest getCategories()

Get All Categories

Get a list of categories used to tag items in Spotify (on, for example, the Spotify player's "Browse" tab).

Returns:

a GetCategoriesRequest object to build and execute the request

getFeaturedPlaylists

public GetFeaturedPlaylistsRequest getFeaturedPlaylists()

Get All Featured Playlists

Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab).

Returns:

a GetFeaturedPlaylistsRequest object to build and execute the request

getNewReleases

public GetNewReleasesRequest getNewReleases()

Get All New Releases

Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player's "Browse" tab).

Returns:

a GetNewReleasesRequest object to build and execute the request

getRecommendationGenres

public GetRecommendationGenresRequest getRecommendationGenres()

Get Recommendation Genres

Retrieve a list of available genres seed parameter values for recommendations.

Returns:

a GetRecommendationGenresRequest object to build and execute the request

getRecommendations

public GetRecommendationsRequest getRecommendations(String seedArtists,
                                                    String seedGenres,
                                                    String seedTracks)

Get Recommendations

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.

Parameters:

seedArtists -

A comma separated list of Spotify IDs for seed artists. Up to 5 seed values may be provided in any combination of seed_artists, seed_tracks and seed_genres.

seedGenres -

A comma separated list of any genres in the set of available genre seeds. Up to 5 seed values may be provided in any combination of seed_artists, seed_tracks and seed_genres.

seedTracks -

A comma separated list of Spotify IDs for a seed track. Up to 5 seed values may be provided in any combination of seed_artists, seed_tracks and seed_genres.

Returns:

a GetRecommendationsRequest object to build and execute the request