public interface SpotifyService
| Modifier and Type | Field and Description |
|---|---|
static String |
ALBUM_TYPE
A comma-separated list of keywords that will be used to filter the response.
|
static String |
COUNTRY
Same as
MARKET |
static String |
FIELDS
Filters for the query: a comma-separated list of the fields to return.
|
static String |
LIMIT
The maximum number of objects to return.
|
static String |
LOCALE
The desired language, consisting of a lowercase ISO 639 language code
and an uppercase ISO 3166-1 alpha-2 country code, joined by an underscore.
|
static String |
MARKET
The country: an ISO 3166-1 alpha-2 country code.
|
static String |
OFFSET
The index of the first playlist to return.
|
static String |
TIME_RANGE |
static String |
TIMESTAMP
A timestamp in ISO 8601 format: yyyy-MM-ddTHH:mm:ss.
|
| Modifier and Type | Method and Description |
|---|---|
Result |
addToMySavedAlbums(String ids)
Save one or more albums to the current user’s “Your Music” library.
|
void |
addToMySavedAlbums(String ids,
retrofit.Callback<Object> callback)
Save one or more albums to the current user’s “Your Music” library.
|
Result |
addToMySavedTracks(String ids)
Save one or more tracks to the current user’s “Your Music” library.
|
void |
addToMySavedTracks(String ids,
retrofit.Callback<Object> callback)
Save one or more tracks to the current user’s “Your Music” library.
|
SnapshotId |
addTracksToPlaylist(String userId,
String playlistId,
Map<String,Object> queryParameters,
Map<String,Object> body)
Add tracks to a playlist
|
void |
addTracksToPlaylist(String userId,
String playlistId,
Map<String,Object> queryParameters,
Map<String,Object> body,
retrofit.Callback<Pager<PlaylistTrack>> callback)
Add tracks to a playlist
|
Boolean[] |
areFollowingPlaylist(String userId,
String playlistId,
String ids)
Check to see if one or more Spotify users are following a specified playlist.
|
void |
areFollowingPlaylist(String userId,
String playlistId,
String ids,
retrofit.Callback<boolean[]> callback)
Check to see if one or more Spotify users are following a specified playlist.
|
Result |
changePlaylistDetails(String userId,
String playlistId,
Map<String,Object> body)
Change a playlist’s name and public/private state.
|
void |
changePlaylistDetails(String userId,
String playlistId,
Map<String,Object> body,
retrofit.Callback<Result> callback)
Change a playlist’s name and public/private state.
|
Boolean[] |
containsMySavedAlbums(String ids)
Check if one or more albums is already saved in the current Spotify user’s “Your Music” library.
|
void |
containsMySavedAlbums(String ids,
retrofit.Callback<boolean[]> callback)
Check if one or more albums is already saved in the current Spotify user’s “Your Music” library.
|
Boolean[] |
containsMySavedTracks(String ids)
Check if one or more tracks is already saved in the current Spotify user’s “Your Music” library.
|
void |
containsMySavedTracks(String ids,
retrofit.Callback<boolean[]> callback)
Check if one or more tracks is already saved in the current Spotify user’s “Your Music” library.
|
Playlist |
createPlaylist(String userId,
Map<String,Object> options)
Create a playlist
|
void |
createPlaylist(String userId,
Map<String,Object> body,
retrofit.Callback<Playlist> callback)
Create a playlist
|
Result |
followArtists(String ids)
Add the current user as a follower of one or more Spotify artists.
|
void |
followArtists(String ids,
retrofit.Callback<Object> callback)
Add the current user as a follower of one or more artists.
|
Result |
followPlaylist(String userId,
String playlistId)
Add the current user as a follower of a playlist.
|
void |
followPlaylist(String userId,
String playlistId,
retrofit.Callback<Result> callback)
Add the current user as a follower of a playlist.
|
Result |
followPlaylist(String userId,
String playlistId,
PlaylistFollowPrivacy playlistFollowPrivacy)
Add the current user as a follower of a playlist.
|
void |
followPlaylist(String userId,
String playlistId,
PlaylistFollowPrivacy playlistFollowPrivacy,
retrofit.Callback<Result> callback)
Add the current user as a follower of a playlist.
|
Result |
followUsers(String ids)
Add the current user as a follower of one or more Spotify users.
|
void |
followUsers(String ids,
retrofit.Callback<Object> callback)
Add the current user as a follower of one or more Spotify users.
|
Album |
getAlbum(String albumId)
Get Spotify catalog information for a single album.
|
void |
getAlbum(String albumId,
retrofit.Callback<Album> callback)
Get Spotify catalog information for a single album.
|
Album |
getAlbum(String albumId,
Map<String,Object> options)
Get Spotify catalog information for a single album.
|
void |
getAlbum(String albumId,
Map<String,Object> options,
retrofit.Callback<Album> callback)
Get Spotify catalog information for a single album.
|
Albums |
getAlbums(String albumIds)
Get Spotify catalog information for multiple albums identified by their Spotify IDs.
|
void |
getAlbums(String albumIds,
retrofit.Callback<Albums> callback)
Get Spotify catalog information for multiple albums identified by their Spotify IDs.
|
Albums |
getAlbums(String albumIds,
Map<String,Object> options)
Get Spotify catalog information for multiple albums identified by their Spotify IDs.
|
void |
getAlbums(String albumIds,
Map<String,Object> options,
retrofit.Callback<Albums> callback)
Get Spotify catalog information for multiple albums identified by their Spotify IDs.
|
Pager<Track> |
getAlbumTracks(String albumId)
Get Spotify catalog information about an album’s tracks.
|
void |
getAlbumTracks(String albumId,
retrofit.Callback<Pager<Track>> callback)
Get Spotify catalog information about an album’s tracks.
|
Pager<Track> |
getAlbumTracks(String albumId,
Map<String,Object> options)
Get Spotify catalog information about an album’s tracks.
|
void |
getAlbumTracks(String albumId,
Map<String,Object> options,
retrofit.Callback<Pager<Track>> callback)
Get Spotify catalog information about an album’s tracks.
|
Artist |
getArtist(String artistId)
Get Spotify catalog information for a single artist identified by their unique Spotify ID.
|
void |
getArtist(String artistId,
retrofit.Callback<Artist> callback)
Get Spotify catalog information for a single artist identified by their unique Spotify ID.
|
Pager<Album> |
getArtistAlbums(String artistId)
Get Spotify catalog information about an artist’s albums.
|
void |
getArtistAlbums(String artistId,
retrofit.Callback<Pager<Album>> callback)
Get Spotify catalog information about an artist’s albums.
|
Pager<Album> |
getArtistAlbums(String artistId,
Map<String,Object> options)
Get Spotify catalog information about an artist’s albums.
|
void |
getArtistAlbums(String artistId,
Map<String,Object> options,
retrofit.Callback<Pager<Album>> callback)
Get Spotify catalog information about an artist’s albums.
|
Artists |
getArtists(String artistIds)
Get Spotify catalog information for several artists based on their Spotify IDs.
|
void |
getArtists(String artistIds,
retrofit.Callback<Artists> callback)
Get Spotify catalog information for several artists based on their Spotify IDs.
|
Tracks |
getArtistTopTrack(String artistId,
String country)
Get Spotify catalog information about an artist’s top tracks by country.
|
void |
getArtistTopTrack(String artistId,
String country,
retrofit.Callback<Tracks> callback)
Get Spotify catalog information about an artist’s top tracks by country.
|
CategoriesPager |
getCategories(Map<String,Object> options)
Retrieve Spotify categories.
|
void |
getCategories(Map<String,Object> options,
retrofit.Callback<CategoriesPager> callback)
Retrieve Spotify categories.
|
Category |
getCategory(String categoryId,
Map<String,Object> options)
Retrieve a Spotify category.
|
void |
getCategory(String categoryId,
Map<String,Object> options,
retrofit.Callback<Category> callback)
Retrieve a Spotify category.
|
FeaturedPlaylists |
getFeaturedPlaylists()
Get a list of Spotify featured playlists (shown, for example, on a Spotify player’s “Browse” tab).
|
void |
getFeaturedPlaylists(retrofit.Callback<FeaturedPlaylists> callback)
Get a list of Spotify featured playlists (shown, for example, on a Spotify player’s “Browse” tab).
|
FeaturedPlaylists |
getFeaturedPlaylists(Map<String,Object> options)
Get a list of Spotify featured playlists (shown, for example, on a Spotify player’s “Browse” tab).
|
void |
getFeaturedPlaylists(Map<String,Object> options,
retrofit.Callback<FeaturedPlaylists> callback)
Get a list of Spotify featured playlists (shown, for example, on a Spotify player’s “Browse” tab).
|
ArtistsCursorPager |
getFollowedArtists()
Get the current user's followed artists.
|
void |
getFollowedArtists(retrofit.Callback<ArtistsCursorPager> callback)
Get the current user's followed artists.
|
ArtistsCursorPager |
getFollowedArtists(Map<String,Object> options)
Get the current user's followed artists.
|
void |
getFollowedArtists(Map<String,Object> options,
retrofit.Callback<ArtistsCursorPager> callback)
Get the current user's followed artists.
|
UserPrivate |
getMe()
Get the currently logged in user profile information.
|
void |
getMe(retrofit.Callback<UserPrivate> callback)
Get the currently logged in user profile information.
|
Pager<PlaylistSimple> |
getMyPlaylists()
Get a list of the playlists owned or followed by the current Spotify user.
|
void |
getMyPlaylists(retrofit.Callback<Pager<PlaylistSimple>> callback)
Get a list of the playlists owned or followed by the current Spotify user.
|
Pager<PlaylistSimple> |
getMyPlaylists(Map<String,Object> options)
Get a list of the playlists owned or followed by the current Spotify user.
|
void |
getMyPlaylists(Map<String,Object> options,
retrofit.Callback<Pager<PlaylistSimple>> callback)
Get a list of the playlists owned or followed by the current Spotify user.
|
Pager<SavedAlbum> |
getMySavedAlbums()
Get a list of the albums saved in the current Spotify user’s “Your Music” library.
|
void |
getMySavedAlbums(retrofit.Callback<Pager<SavedAlbum>> callback)
Get a list of the albums saved in the current Spotify user’s “Your Music” library.
|
Pager<SavedAlbum> |
getMySavedAlbums(Map<String,Object> options)
Get a list of the albums saved in the current Spotify user’s “Your Music” library.
|
void |
getMySavedAlbums(Map<String,Object> options,
retrofit.Callback<Pager<SavedAlbum>> callback)
Get a list of the albums saved in the current Spotify user’s “Your Music” library.
|
Pager<SavedTrack> |
getMySavedTracks()
Get a list of the songs saved in the current Spotify user’s “Your Music” library.
|
void |
getMySavedTracks(retrofit.Callback<Pager<SavedTrack>> callback)
Get a list of the songs saved in the current Spotify user’s “Your Music” library.
|
Pager<SavedTrack> |
getMySavedTracks(Map<String,Object> options)
Get a list of the songs saved in the current Spotify user’s “Your Music” library.
|
void |
getMySavedTracks(Map<String,Object> options,
retrofit.Callback<Pager<SavedTrack>> callback)
Get a list of the songs saved in the current Spotify user’s “Your Music” library.
|
NewReleases |
getNewReleases()
Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).
|
void |
getNewReleases(retrofit.Callback<NewReleases> callback)
Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).
|
NewReleases |
getNewReleases(Map<String,Object> options)
Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).
|
void |
getNewReleases(Map<String,Object> options,
retrofit.Callback<NewReleases> callback)
Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).
|
Playlist |
getPlaylist(String userId,
String playlistId)
Get a playlist owned by a Spotify user.
|
void |
getPlaylist(String userId,
String playlistId,
retrofit.Callback<Playlist> callback)
Get a playlist owned by a Spotify user.
|
Playlist |
getPlaylist(String userId,
String playlistId,
Map<String,Object> options)
Get a playlist owned by a Spotify user.
|
void |
getPlaylist(String userId,
String playlistId,
Map<String,Object> options,
retrofit.Callback<Playlist> callback)
Get a playlist owned by a Spotify user.
|
Pager<PlaylistSimple> |
getPlaylists(String userId)
Get a list of the playlists owned or followed by a Spotify user.
|
void |
getPlaylists(String userId,
retrofit.Callback<Pager<PlaylistSimple>> callback)
Get a list of the playlists owned or followed by a Spotify user.
|
Pager<PlaylistSimple> |
getPlaylists(String userId,
Map<String,Object> options)
Get a list of the playlists owned or followed by a Spotify user.
|
void |
getPlaylists(String userId,
Map<String,Object> options,
retrofit.Callback<Pager<PlaylistSimple>> callback)
Get a list of the playlists owned or followed by a Spotify user.
|
PlaylistsPager |
getPlaylistsForCategory(String categoryId,
Map<String,Object> options)
Retrieve playlists for a Spotify Category.
|
void |
getPlaylistsForCategory(String categoryId,
Map<String,Object> options,
retrofit.Callback<PlaylistsPager> callback)
Retrieve playlists for a Spotify Category.
|
Pager<PlaylistTrack> |
getPlaylistTracks(String userId,
String playlistId)
Get full details of the tracks of a playlist owned by a Spotify user.
|
void |
getPlaylistTracks(String userId,
String playlistId,
retrofit.Callback<Pager<PlaylistTrack>> callback)
Get full details of the tracks of a playlist owned by a Spotify user.
|
Pager<PlaylistTrack> |
getPlaylistTracks(String userId,
String playlistId,
Map<String,Object> options)
Get full details of the tracks of a playlist owned by a Spotify user.
|
void |
getPlaylistTracks(String userId,
String playlistId,
Map<String,Object> options,
retrofit.Callback<Pager<PlaylistTrack>> callback)
Get full details of the tracks of a playlist owned by a Spotify user.
|
Recommendations |
getRecommendations(Map<String,Object> options)
Create a playlist-style listening experience based on seed artists, tracks and genres.
|
void |
getRecommendations(Map<String,Object> options,
retrofit.Callback<Recommendations> callback)
Create a playlist-style listening experience based on seed artists, tracks and genres.
|
Artists |
getRelatedArtists(String artistId)
Get Spotify catalog information about artists similar to a given artist.
|
void |
getRelatedArtists(String artistId,
retrofit.Callback<Artists> callback)
Get Spotify catalog information about artists similar to a given artist.
|
SeedsGenres |
getSeedsGenres()
Retrieve a list of available genres seed parameter values for recommendations.
|
void |
getSeedsGenres(retrofit.Callback<SeedsGenres> callback)
Retrieve a list of available genres seed parameter values for recommendations.
|
Pager<Artist> |
getTopArtists()
Get the current user’s top artists based on calculated affinity.
|
void |
getTopArtists(retrofit.Callback<Pager<Artist>> callback)
Get the current user’s top artists based on calculated affinity.
|
Pager<Artist> |
getTopArtists(Map<String,Object> options)
Get the current user’s top artists based on calculated affinity.
|
void |
getTopArtists(Map<String,Object> options,
retrofit.Callback<Pager<Artist>> callback)
Get the current user’s top artists based on calculated affinity.
|
Pager<Track> |
getTopTracks()
Get the current user’s top tracks based on calculated affinity.
|
void |
getTopTracks(retrofit.Callback<Pager<Track>> callback)
Get the current user’s top tracks based on calculated affinity.
|
Pager<Track> |
getTopTracks(Map<String,Object> options)
Get the current user’s top tracks based on calculated affinity.
|
void |
getTopTracks(Map<String,Object> options,
retrofit.Callback<Pager<Track>> callback)
Get the current user’s top tracks based on calculated affinity.
|
Track |
getTrack(String trackId)
Get Spotify catalog information for a single track identified by their unique Spotify ID.
|
void |
getTrack(String trackId,
retrofit.Callback<Track> callback)
Get Spotify catalog information for a single track identified by their unique Spotify ID.
|
Track |
getTrack(String trackId,
Map<String,Object> options)
Get Spotify catalog information for a single track identified by their unique Spotify ID.
|
void |
getTrack(String trackId,
Map<String,Object> options,
retrofit.Callback<Track> callback)
Get Spotify catalog information for a single track identified by their unique Spotify ID.
|
AudioFeaturesTrack |
getTrackAudioFeatures(String id)
Get audio feature information for a single track identified by its unique Spotify ID.
|
void |
getTrackAudioFeatures(String id,
retrofit.Callback<AudioFeaturesTrack> callback)
Get audio feature information for a single track identified by its unique Spotify ID.
|
Tracks |
getTracks(String trackIds)
Get Several Tracks
|
void |
getTracks(String trackIds,
retrofit.Callback<Tracks> callback)
Get Several Tracks
|
Tracks |
getTracks(String trackIds,
Map<String,Object> options)
Get Several Tracks
|
void |
getTracks(String trackIds,
Map<String,Object> options,
retrofit.Callback<Tracks> callback)
Get Several Tracks
|
AudioFeaturesTracks |
getTracksAudioFeatures(String ids)
Get audio features for multiple tracks based on their Spotify IDs.
|
void |
getTracksAudioFeatures(String ids,
retrofit.Callback<AudioFeaturesTracks> callback)
Get audio features for multiple tracks based on their Spotify IDs.
|
UserPublic |
getUser(String userId)
Get a user's profile information.
|
void |
getUser(String userId,
retrofit.Callback<UserPublic> callback)
Get a user's profile information.
|
Boolean[] |
isFollowingArtists(String ids)
Check to see if the current user is following one or more other Spotify artists.
|
void |
isFollowingArtists(String ids,
retrofit.Callback<boolean[]> callback)
Check to see if the current user is following one or more other Spotify artists.
|
Boolean[] |
isFollowingUsers(String ids)
Check to see if the current user is following one or more other Spotify users.
|
void |
isFollowingUsers(String ids,
retrofit.Callback<boolean[]> callback)
Check to see if the current user is following one or more other Spotify users.
|
Result |
removeFromMySavedAlbums(String ids)
Remove one or more albums from the current user’s “Your Music” library.
|
void |
removeFromMySavedAlbums(String ids,
retrofit.Callback<Object> callback)
Remove one or more albums from the current user’s “Your Music” library.
|
Result |
removeFromMySavedTracks(String ids)
Remove one or more tracks from the current user’s “Your Music” library.
|
void |
removeFromMySavedTracks(String ids,
retrofit.Callback<Object> callback)
Remove one or more tracks from the current user’s “Your Music” library.
|
SnapshotId |
removeTracksFromPlaylist(String userId,
String playlistId,
TracksToRemove tracksToRemove)
Remove one or more tracks from a user’s playlist.
|
void |
removeTracksFromPlaylist(String userId,
String playlistId,
TracksToRemove tracksToRemove,
retrofit.Callback<SnapshotId> callback)
Remove one or more tracks from a user’s playlist.
|
SnapshotId |
removeTracksFromPlaylist(String userId,
String playlistId,
TracksToRemoveWithPosition tracksToRemoveWithPosition)
Remove one or more tracks from a user’s playlist.
|
void |
removeTracksFromPlaylist(String userId,
String playlistId,
TracksToRemoveWithPosition tracksToRemoveWithPosition,
retrofit.Callback<SnapshotId> callback)
Remove one or more tracks from a user’s playlist.
|
SnapshotId |
reorderPlaylistTracks(String userId,
String playlistId,
Map<String,Object> body)
Reorder a Playlist's tracks
|
void |
reorderPlaylistTracks(String userId,
String playlistId,
Map<String,Object> body,
retrofit.Callback<SnapshotId> callback)
Reorder a Playlist's tracks
|
Result |
replaceTracksInPlaylist(String userId,
String playlistId,
String trackUris,
Object body)
Replace all the tracks in a playlist, overwriting its existing tracks.
|
void |
replaceTracksInPlaylist(String userId,
String playlistId,
String trackUris,
Object body,
retrofit.Callback<Result> callback)
Replace all the tracks in a playlist, overwriting its existing tracks.
|
AlbumsPager |
searchAlbums(String q)
Get Spotify catalog information about albums that match a keyword string.
|
void |
searchAlbums(String q,
retrofit.Callback<AlbumsPager> callback)
Get Spotify catalog information about albums that match a keyword string.
|
AlbumsPager |
searchAlbums(String q,
Map<String,Object> options)
Get Spotify catalog information about albums that match a keyword string.
|
void |
searchAlbums(String q,
Map<String,Object> options,
retrofit.Callback<AlbumsPager> callback)
Get Spotify catalog information about albums that match a keyword string.
|
ArtistsPager |
searchArtists(String q)
Get Spotify catalog information about artists that match a keyword string.
|
void |
searchArtists(String q,
retrofit.Callback<ArtistsPager> callback)
Get Spotify catalog information about artists that match a keyword string.
|
ArtistsPager |
searchArtists(String q,
Map<String,Object> options)
Get Spotify catalog information about artists that match a keyword string.
|
void |
searchArtists(String q,
Map<String,Object> options,
retrofit.Callback<ArtistsPager> callback)
Get Spotify catalog information about artists that match a keyword string.
|
PlaylistsPager |
searchPlaylists(String q)
Get Spotify catalog information about playlists that match a keyword string.
|
void |
searchPlaylists(String q,
retrofit.Callback<PlaylistsPager> callback)
Get Spotify catalog information about playlists that match a keyword string.
|
PlaylistsPager |
searchPlaylists(String q,
Map<String,Object> options)
Get Spotify catalog information about playlists that match a keyword string.
|
void |
searchPlaylists(String q,
Map<String,Object> options,
retrofit.Callback<PlaylistsPager> callback)
Get Spotify catalog information about playlists that match a keyword string.
|
TracksPager |
searchTracks(String q)
Get Spotify catalog information about tracks that match a keyword string.
|
void |
searchTracks(String q,
retrofit.Callback<TracksPager> callback)
Get Spotify catalog information about tracks that match a keyword string.
|
TracksPager |
searchTracks(String q,
Map<String,Object> options)
Get Spotify catalog information about tracks that match a keyword string.
|
void |
searchTracks(String q,
Map<String,Object> options,
retrofit.Callback<TracksPager> callback)
Get Spotify catalog information about tracks that match a keyword string.
|
Result |
unfollowArtists(String ids)
Remove the current user as a follower of one or more Spotify artists.
|
void |
unfollowArtists(String ids,
retrofit.Callback<Object> callback)
Remove the current user as a follower of one or more Spotify artists.
|
Result |
unfollowPlaylist(String userId,
String playlistId)
Unfollow a Playlist
|
void |
unfollowPlaylist(String userId,
String playlistId,
retrofit.Callback<Result> callback)
Unfollow a Playlist
|
Result |
unfollowUsers(String ids)
Remove the current user as a follower of one or more Spotify users.
|
void |
unfollowUsers(String ids,
retrofit.Callback<Object> callback)
Remove the current user as a follower of one or more Spotify users.
|
static final String LIMIT
static final String OFFSET
static final String ALBUM_TYPE
album, single, appears_on, compilationstatic final String MARKET
COUNTRYstatic final String COUNTRY
MARKETstatic final String LOCALE
static final String FIELDS
static final String TIMESTAMP
static final String TIME_RANGE
@GET(value="/me") void getMe(retrofit.Callback<UserPrivate> callback)
callback - Callback method@GET(value="/me") UserPrivate getMe()
@GET(value="/users/{id}")
void getUser(@Path(value="id")
String userId,
retrofit.Callback<UserPublic> callback)
userId - The user's User IDcallback - Callback method@GET(value="/users/{id}")
UserPublic getUser(@Path(value="id")
String userId)
userId - The user's User ID@GET(value="/me/playlists") void getMyPlaylists(retrofit.Callback<Pager<PlaylistSimple>> callback)
callback - Callback method.@GET(value="/me/playlists") Pager<PlaylistSimple> getMyPlaylists()
Pager object@GET(value="/me/playlists")
void getMyPlaylists(@QueryMap
Map<String,Object> options,
retrofit.Callback<Pager<PlaylistSimple>> callback)
options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method.@GET(value="/me/playlists") Pager<PlaylistSimple> getMyPlaylists(@QueryMap Map<String,Object> options)
options - Optional parameters. For list of supported parameters see
endpoint documentationPager object@GET(value="/users/{id}/playlists")
void getPlaylists(@Path(value="id")
String userId,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Pager<PlaylistSimple>> callback)
userId - The user's Spotify user ID.options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/users/{id}/playlists")
Pager<PlaylistSimple> getPlaylists(@Path(value="id")
String userId,
@QueryMap
Map<String,Object> options)
userId - The user's Spotify user ID.options - Optional parameters. For list of supported parameters see
endpoint documentationPager object@GET(value="/users/{id}/playlists")
void getPlaylists(@Path(value="id")
String userId,
retrofit.Callback<Pager<PlaylistSimple>> callback)
userId - The user's Spotify user ID.callback - Callback method@GET(value="/users/{id}/playlists")
Pager<PlaylistSimple> getPlaylists(@Path(value="id")
String userId)
userId - The user's Spotify user ID.Pager object@GET(value="/users/{user_id}/playlists/{playlist_id}")
void getPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Playlist> callback)
userId - The user's Spotify user ID.playlistId - The Spotify ID for the playlist.options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/users/{user_id}/playlists/{playlist_id}")
Playlist getPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@QueryMap
Map<String,Object> options)
userId - The user's Spotify user ID.playlistId - The Spotify ID for the playlist.options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/users/{user_id}/playlists/{playlist_id}")
void getPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
retrofit.Callback<Playlist> callback)
userId - The user's Spotify user ID.playlistId - The Spotify ID for the playlist.callback - Callback method@GET(value="/users/{user_id}/playlists/{playlist_id}")
Playlist getPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId)
userId - The user's Spotify user ID.playlistId - The Spotify ID for the playlist.@GET(value="/users/{user_id}/playlists/{playlist_id}/tracks")
void getPlaylistTracks(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Pager<PlaylistTrack>> callback)
userId - The user's Spotify user ID.playlistId - The Spotify ID for the playlist.options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/users/{user_id}/playlists/{playlist_id}/tracks")
Pager<PlaylistTrack> getPlaylistTracks(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@QueryMap
Map<String,Object> options)
userId - The user's Spotify user ID.playlistId - The Spotify ID for the playlist.options - Optional parameters. For list of supported parameters see
endpoint documentationPager object@GET(value="/users/{user_id}/playlists/{playlist_id}/tracks")
void getPlaylistTracks(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
retrofit.Callback<Pager<PlaylistTrack>> callback)
userId - The user's Spotify user ID.playlistId - The Spotify ID for the playlist.callback - Callback method@GET(value="/users/{user_id}/playlists/{playlist_id}/tracks")
Pager<PlaylistTrack> getPlaylistTracks(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId)
userId - The user's Spotify user ID.playlistId - The Spotify ID for the playlist.Pager object@POST(value="/users/{user_id}/playlists")
void createPlaylist(@Path(value="user_id")
String userId,
@Body
Map<String,Object> body,
retrofit.Callback<Playlist> callback)
userId - The playlist's owner's User IDbody - The body parameterscallback - Callback method@POST(value="/users/{user_id}/playlists")
Playlist createPlaylist(@Path(value="user_id")
String userId,
@Body
Map<String,Object> options)
userId - The playlist's owner's User IDoptions - The body parameters@POST(value="/users/{user_id}/playlists/{playlist_id}/tracks")
SnapshotId addTracksToPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@QueryMap
Map<String,Object> queryParameters,
@Body
Map<String,Object> body)
userId - The owner of the playlistplaylistId - The playlist's IDqueryParameters - Query parametersbody - The body parameters@POST(value="/users/{user_id}/playlists/{playlist_id}/tracks")
void addTracksToPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@QueryMap
Map<String,Object> queryParameters,
@Body
Map<String,Object> body,
retrofit.Callback<Pager<PlaylistTrack>> callback)
userId - The owner of the playlistplaylistId - The playlist's IdqueryParameters - Query parametersbody - The body parameterscallback - Callback method@DELETEWITHBODY(value="/users/{user_id}/playlists/{playlist_id}/tracks") void removeTracksFromPlaylist(@Path(value="user_id") String userId, @Path(value="playlist_id") String playlistId, @Body TracksToRemove tracksToRemove, retrofit.Callback<SnapshotId> callback)
userId - The owner of the playlistplaylistId - The playlist's IdtracksToRemove - A list of tracks to removecallback - Callback method@DELETEWITHBODY(value="/users/{user_id}/playlists/{playlist_id}/tracks") SnapshotId removeTracksFromPlaylist(@Path(value="user_id") String userId, @Path(value="playlist_id") String playlistId, @Body TracksToRemove tracksToRemove)
userId - The owner of the playlistplaylistId - The playlist's IdtracksToRemove - A list of tracks to remove@DELETEWITHBODY(value="/users/{user_id}/playlists/{playlist_id}/tracks") void removeTracksFromPlaylist(@Path(value="user_id") String userId, @Path(value="playlist_id") String playlistId, @Body TracksToRemoveWithPosition tracksToRemoveWithPosition, retrofit.Callback<SnapshotId> callback)
userId - The owner of the playlistplaylistId - The playlist's IdtracksToRemoveWithPosition - A list of tracks to remove, together with their specific positionscallback - Callback method@DELETEWITHBODY(value="/users/{user_id}/playlists/{playlist_id}/tracks") SnapshotId removeTracksFromPlaylist(@Path(value="user_id") String userId, @Path(value="playlist_id") String playlistId, @Body TracksToRemoveWithPosition tracksToRemoveWithPosition)
userId - The owner of the playlistplaylistId - The playlist's IdtracksToRemoveWithPosition - A list of tracks to remove, together with their specific positions@PUT(value="/users/{user_id}/playlists/{playlist_id}/tracks")
void replaceTracksInPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Query(value="uris")
String trackUris,
@Body
Object body,
retrofit.Callback<Result> callback)
userId - The owner of the playlistplaylistId - The playlist's IdtrackUris - A list of comma-separated track uriscallback - Callback method@PUT(value="/users/{user_id}/playlists/{playlist_id}/tracks")
Result replaceTracksInPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Query(value="uris")
String trackUris,
@Body
Object body)
userId - The owner of the playlistplaylistId - The playlist's IdtrackUris - A list of comma-separated track uris@PUT(value="/users/{user_id}/playlists/{playlist_id}")
Result changePlaylistDetails(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Body
Map<String,Object> body)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The playlist's Idbody - The body parameters. For list of supported parameters see endpoint documentation@PUT(value="/users/{user_id}/playlists/{playlist_id}")
void changePlaylistDetails(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Body
Map<String,Object> body,
retrofit.Callback<Result> callback)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The playlist's Idbody - The body parameters. For list of supported parameters see endpoint documentationcallback - Callback method@PUT(value="/users/{user_id}/playlists/{playlist_id}/followers")
void followPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
retrofit.Callback<Result> callback)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The Spotify ID of the playlistcallback - Callback method@PUT(value="/users/{user_id}/playlists/{playlist_id}/followers")
Result followPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The Spotify ID of the playlist@PUT(value="/users/{user_id}/playlists/{playlist_id}/followers")
void followPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Body
PlaylistFollowPrivacy playlistFollowPrivacy,
retrofit.Callback<Result> callback)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The Spotify ID of the playlistplaylistFollowPrivacy - The privacy state of the playlistcallback - Callback method@PUT(value="/users/{user_id}/playlists/{playlist_id}/followers")
Result followPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Body
PlaylistFollowPrivacy playlistFollowPrivacy)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The Spotify ID of the playlistplaylistFollowPrivacy - The privacy state of the playlist@DELETE(value="/users/{user_id}/playlists/{playlist_id}/followers")
void unfollowPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
retrofit.Callback<Result> callback)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The Spotify ID of the playlistcallback - Callback method@DELETE(value="/users/{user_id}/playlists/{playlist_id}/followers")
Result unfollowPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The Spotify ID of the playlist@PUT(value="/users/{user_id}/playlists/{playlist_id}/tracks")
SnapshotId reorderPlaylistTracks(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Body
Map<String,Object> body)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The Spotify ID of the playlistbody - The body parameters. For list of supported parameters see endpoint documentation@PUT(value="/users/{user_id}/playlists/{playlist_id}/tracks")
void reorderPlaylistTracks(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Body
Map<String,Object> body,
retrofit.Callback<SnapshotId> callback)
userId - The Spotify user ID of the user who owns the playlist.playlistId - The Spotify ID of the playlistbody - The body parameters. For list of supported parameters see endpoint documentationcallback - Callback method@GET(value="/albums/{id}")
void getAlbum(@Path(value="id")
String albumId,
retrofit.Callback<Album> callback)
albumId - The Spotify ID for the album.callback - Callback method@GET(value="/albums/{id}")
Album getAlbum(@Path(value="id")
String albumId)
albumId - The Spotify ID for the album.@GET(value="/albums/{id}")
void getAlbum(@Path(value="id")
String albumId,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Album> callback)
albumId - The Spotify ID for the album.options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/albums/{id}")
Album getAlbum(@Path(value="id")
String albumId,
@QueryMap
Map<String,Object> options)
albumId - The Spotify ID for the album.options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/albums")
void getAlbums(@Query(value="ids")
String albumIds,
retrofit.Callback<Albums> callback)
albumIds - A comma-separated list of the Spotify IDs for the albumscallback - Callback method@GET(value="/albums") Albums getAlbums(@Query(value="ids") String albumIds)
albumIds - A comma-separated list of the Spotify IDs for the albums@GET(value="/albums")
void getAlbums(@Query(value="ids")
String albumIds,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Albums> callback)
albumIds - A comma-separated list of the Spotify IDs for the albumsoptions - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/albums") Albums getAlbums(@Query(value="ids") String albumIds, @QueryMap Map<String,Object> options)
albumIds - A comma-separated list of the Spotify IDs for the albumsoptions - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/albums/{id}/tracks")
Pager<Track> getAlbumTracks(@Path(value="id")
String albumId)
albumId - The Spotify ID for the album.@GET(value="/albums/{id}/tracks")
void getAlbumTracks(@Path(value="id")
String albumId,
retrofit.Callback<Pager<Track>> callback)
albumId - The Spotify ID for the album.callback - Callback method@GET(value="/albums/{id}/tracks")
void getAlbumTracks(@Path(value="id")
String albumId,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Pager<Track>> callback)
albumId - The Spotify ID for the album.options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/albums/{id}/tracks")
Pager<Track> getAlbumTracks(@Path(value="id")
String albumId,
@QueryMap
Map<String,Object> options)
albumId - The Spotify ID for the album.options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/artists/{id}")
void getArtist(@Path(value="id")
String artistId,
retrofit.Callback<Artist> callback)
artistId - The Spotify ID for the artist.callback - Callback method@GET(value="/artists/{id}")
Artist getArtist(@Path(value="id")
String artistId)
artistId - The Spotify ID for the artist.@GET(value="/artists")
void getArtists(@Query(value="ids")
String artistIds,
retrofit.Callback<Artists> callback)
artistIds - A comma-separated list of the Spotify IDs for the artistscallback - Callback method@GET(value="/artists") Artists getArtists(@Query(value="ids") String artistIds)
artistIds - A comma-separated list of the Spotify IDs for the artists@GET(value="/artists/{id}/albums")
void getArtistAlbums(@Path(value="id")
String artistId,
retrofit.Callback<Pager<Album>> callback)
artistId - The Spotify ID for the artist.callback - Callback method@GET(value="/artists/{id}/albums")
Pager<Album> getArtistAlbums(@Path(value="id")
String artistId)
artistId - The Spotify ID for the artist.@GET(value="/artists/{id}/albums")
void getArtistAlbums(@Path(value="id")
String artistId,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Pager<Album>> callback)
artistId - The Spotify ID for the artist.options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/artists/{id}/albums")
Pager<Album> getArtistAlbums(@Path(value="id")
String artistId,
@QueryMap
Map<String,Object> options)
artistId - The Spotify ID for the artist.options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/artists/{id}/top-tracks")
void getArtistTopTrack(@Path(value="id")
String artistId,
@Query(value="country")
String country,
retrofit.Callback<Tracks> callback)
artistId - The Spotify ID for the artist.country - The country: an ISO 3166-1 alpha-2 country code.callback - Callback method@GET(value="/artists/{id}/top-tracks")
Tracks getArtistTopTrack(@Path(value="id")
String artistId,
@Query(value="country")
String country)
artistId - The Spotify ID for the artist.country - The country: an ISO 3166-1 alpha-2 country code.@GET(value="/artists/{id}/related-artists")
void getRelatedArtists(@Path(value="id")
String artistId,
retrofit.Callback<Artists> callback)
artistId - The Spotify ID for the artist.callback - Callback method.@GET(value="/artists/{id}/related-artists")
Artists getRelatedArtists(@Path(value="id")
String artistId)
artistId - The Spotify ID for the artist.@GET(value="/tracks/{id}")
void getTrack(@Path(value="id")
String trackId,
retrofit.Callback<Track> callback)
trackId - The Spotify ID for the track.callback - Callback method@GET(value="/tracks/{id}")
Track getTrack(@Path(value="id")
String trackId)
trackId - The Spotify ID for the track.@GET(value="/tracks/{id}")
void getTrack(@Path(value="id")
String trackId,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Track> callback)
trackId - The Spotify ID for the track.options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/tracks/{id}")
Track getTrack(@Path(value="id")
String trackId,
@QueryMap
Map<String,Object> options)
trackId - The Spotify ID for the track.options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/tracks")
void getTracks(@Query(value="ids")
String trackIds,
retrofit.Callback<Tracks> callback)
trackIds - A comma-separated list of the Spotify IDs for the trackscallback - Callback method@GET(value="/tracks") Tracks getTracks(@Query(value="ids") String trackIds)
trackIds - A comma-separated list of the Spotify IDs for the tracks@GET(value="/tracks")
void getTracks(@Query(value="ids")
String trackIds,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Tracks> callback)
trackIds - A comma-separated list of the Spotify IDs for the tracksoptions - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/tracks") Tracks getTracks(@Query(value="ids") String trackIds, @QueryMap Map<String,Object> options)
trackIds - A comma-separated list of the Spotify IDs for the tracksoptions - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/browse/featured-playlists") void getFeaturedPlaylists(retrofit.Callback<FeaturedPlaylists> callback)
callback - Callback method@GET(value="/browse/featured-playlists") FeaturedPlaylists getFeaturedPlaylists()
@GET(value="/browse/featured-playlists")
void getFeaturedPlaylists(@QueryMap
Map<String,Object> options,
retrofit.Callback<FeaturedPlaylists> callback)
options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/browse/featured-playlists") FeaturedPlaylists getFeaturedPlaylists(@QueryMap Map<String,Object> options)
options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/browse/new-releases") void getNewReleases(retrofit.Callback<NewReleases> callback)
callback - Callback method@GET(value="/browse/new-releases") NewReleases getNewReleases()
@GET(value="/browse/new-releases")
void getNewReleases(@QueryMap
Map<String,Object> options,
retrofit.Callback<NewReleases> callback)
options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method@GET(value="/browse/new-releases") NewReleases getNewReleases(@QueryMap Map<String,Object> options)
options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/browse/categories")
void getCategories(@QueryMap
Map<String,Object> options,
retrofit.Callback<CategoriesPager> callback)
options - Optional parameters.callback - Callback method.@GET(value="/browse/categories") CategoriesPager getCategories(@QueryMap Map<String,Object> options)
options - Optional parameters.@GET(value="/browse/categories/{category_id}")
void getCategory(@Path(value="category_id")
String categoryId,
@QueryMap
Map<String,Object> options,
retrofit.Callback<Category> callback)
categoryId - The category's ID.options - Optional parameters.callback - Callback method.@GET(value="/browse/categories/{category_id}")
Category getCategory(@Path(value="category_id")
String categoryId,
@QueryMap
Map<String,Object> options)
categoryId - The category's ID.options - Optional parameters.@GET(value="/browse/categories/{category_id}/playlists")
void getPlaylistsForCategory(@Path(value="category_id")
String categoryId,
@QueryMap
Map<String,Object> options,
retrofit.Callback<PlaylistsPager> callback)
categoryId - The category's ID.options - Optional parameters.callback - Callback method.@GET(value="/browse/categories/{category_id}/playlists")
PlaylistsPager getPlaylistsForCategory(@Path(value="category_id")
String categoryId,
@QueryMap
Map<String,Object> options)
categoryId - The category's ID.options - Optional parameters.@GET(value="/me/tracks") void getMySavedTracks(retrofit.Callback<Pager<SavedTrack>> callback)
callback - Callback method.@GET(value="/me/tracks") Pager<SavedTrack> getMySavedTracks()
@GET(value="/me/tracks")
void getMySavedTracks(@QueryMap
Map<String,Object> options,
retrofit.Callback<Pager<SavedTrack>> callback)
options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method.@GET(value="/me/tracks") Pager<SavedTrack> getMySavedTracks(@QueryMap Map<String,Object> options)
options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/me/tracks/contains")
void containsMySavedTracks(@Query(value="ids")
String ids,
retrofit.Callback<boolean[]> callback)
ids - A comma-separated list of the Spotify IDs for the trackscallback - Callback method.@GET(value="/me/tracks/contains") Boolean[] containsMySavedTracks(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the tracks@PUT(value="/me/tracks")
void addToMySavedTracks(@Query(value="ids")
String ids,
retrofit.Callback<Object> callback)
ids - A comma-separated list of the Spotify IDs for the trackscallback - Callback method.@PUT(value="/me/tracks") Result addToMySavedTracks(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the tracks@DELETE(value="/me/tracks")
void removeFromMySavedTracks(@Query(value="ids")
String ids,
retrofit.Callback<Object> callback)
ids - A comma-separated list of the Spotify IDs for the trackscallback - Callback method.@DELETE(value="/me/tracks") Result removeFromMySavedTracks(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the tracks@GET(value="/me/albums") void getMySavedAlbums(retrofit.Callback<Pager<SavedAlbum>> callback)
callback - Callback method.@GET(value="/me/albums") Pager<SavedAlbum> getMySavedAlbums()
@GET(value="/me/albums")
void getMySavedAlbums(@QueryMap
Map<String,Object> options,
retrofit.Callback<Pager<SavedAlbum>> callback)
options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method.@GET(value="/me/albums") Pager<SavedAlbum> getMySavedAlbums(@QueryMap Map<String,Object> options)
options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/me/albums/contains")
void containsMySavedAlbums(@Query(value="ids")
String ids,
retrofit.Callback<boolean[]> callback)
ids - A comma-separated list of the Spotify IDs for the albumscallback - Callback method.@GET(value="/me/albums/contains") Boolean[] containsMySavedAlbums(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the albums@PUT(value="/me/albums")
void addToMySavedAlbums(@Query(value="ids")
String ids,
retrofit.Callback<Object> callback)
ids - A comma-separated list of the Spotify IDs for the albumscallback - Callback method.@PUT(value="/me/albums") Result addToMySavedAlbums(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the albums@DELETE(value="/me/albums")
void removeFromMySavedAlbums(@Query(value="ids")
String ids,
retrofit.Callback<Object> callback)
ids - A comma-separated list of the Spotify IDs for the albumscallback - Callback method.@DELETE(value="/me/albums") Result removeFromMySavedAlbums(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the albums@PUT(value="/me/following?type=user")
void followUsers(@Query(value="ids")
String ids,
retrofit.Callback<Object> callback)
ids - A comma-separated list of the Spotify IDs for the userscallback - Callback method.@PUT(value="/me/following?type=user") Result followUsers(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the users@PUT(value="/me/following?type=artist")
void followArtists(@Query(value="ids")
String ids,
retrofit.Callback<Object> callback)
ids - A comma-separated list of the Spotify IDs for the artistscallback - Callback method.@PUT(value="/me/following?type=artist") Result followArtists(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the artists@DELETE(value="/me/following?type=user")
void unfollowUsers(@Query(value="ids")
String ids,
retrofit.Callback<Object> callback)
ids - A comma-separated list of the Spotify IDs for the userscallback - Callback method.@DELETE(value="/me/following?type=user") Result unfollowUsers(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the users@DELETE(value="/me/following?type=artist")
void unfollowArtists(@Query(value="ids")
String ids,
retrofit.Callback<Object> callback)
ids - A comma-separated list of the Spotify IDs for the artistscallback - Callback method.@DELETE(value="/me/following?type=artist") Result unfollowArtists(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the artists@GET(value="/me/following/contains?type=user")
void isFollowingUsers(@Query(value="ids")
String ids,
retrofit.Callback<boolean[]> callback)
ids - A comma-separated list of the Spotify IDs for the userscallback - Callback method.@GET(value="/me/following/contains?type=user") Boolean[] isFollowingUsers(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the users@GET(value="/me/following/contains?type=artist")
void isFollowingArtists(@Query(value="ids")
String ids,
retrofit.Callback<boolean[]> callback)
ids - A comma-separated list of the Spotify IDs for the artistscallback - Callback method.@GET(value="/me/following/contains?type=artist") Boolean[] isFollowingArtists(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the artists@GET(value="/users/{user_id}/playlists/{playlist_id}/followers/contains")
Boolean[] areFollowingPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Query(value="ids")
String ids)
userId - The Spotify user ID of the person who owns the playlist.playlistId - The Spotify ID of the playlist.ids - A comma-separated list of the Spotify IDs for the users@GET(value="/users/{user_id}/playlists/{playlist_id}/followers/contains")
void areFollowingPlaylist(@Path(value="user_id")
String userId,
@Path(value="playlist_id")
String playlistId,
@Query(value="ids")
String ids,
retrofit.Callback<boolean[]> callback)
userId - The Spotify user ID of the person who owns the playlist.playlistId - The Spotify ID of the playlist.ids - A comma-separated list of the Spotify IDs for the userscallback - Callback method.@GET(value="/me/following?type=artist") ArtistsCursorPager getFollowedArtists()
@GET(value="/me/following?type=artist") void getFollowedArtists(retrofit.Callback<ArtistsCursorPager> callback)
callback - Callback method.@GET(value="/me/following?type=artist") ArtistsCursorPager getFollowedArtists(@QueryMap Map<String,Object> options)
options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/me/following?type=artist")
void getFollowedArtists(@QueryMap
Map<String,Object> options,
retrofit.Callback<ArtistsCursorPager> callback)
options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method.@GET(value="/search?type=track")
void searchTracks(@Query(value="q")
String q,
retrofit.Callback<TracksPager> callback)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"callback - Callback method.@GET(value="/search?type=track") TracksPager searchTracks(@Query(value="q") String q)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"@GET(value="/search?type=track")
void searchTracks(@Query(value="q")
String q,
@QueryMap
Map<String,Object> options,
retrofit.Callback<TracksPager> callback)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method.@GET(value="/search?type=track") TracksPager searchTracks(@Query(value="q") String q, @QueryMap Map<String,Object> options)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/search?type=artist")
void searchArtists(@Query(value="q")
String q,
retrofit.Callback<ArtistsPager> callback)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"callback - Callback method.@GET(value="/search?type=artist") ArtistsPager searchArtists(@Query(value="q") String q)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"@GET(value="/search?type=artist")
void searchArtists(@Query(value="q")
String q,
@QueryMap
Map<String,Object> options,
retrofit.Callback<ArtistsPager> callback)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method.@GET(value="/search?type=artist") ArtistsPager searchArtists(@Query(value="q") String q, @QueryMap Map<String,Object> options)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/search?type=album")
void searchAlbums(@Query(value="q")
String q,
retrofit.Callback<AlbumsPager> callback)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"callback - Callback method.@GET(value="/search?type=album") AlbumsPager searchAlbums(@Query(value="q") String q)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"@GET(value="/search?type=album")
void searchAlbums(@Query(value="q")
String q,
@QueryMap
Map<String,Object> options,
retrofit.Callback<AlbumsPager> callback)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method.@GET(value="/search?type=album") AlbumsPager searchAlbums(@Query(value="q") String q, @QueryMap Map<String,Object> options)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/search?type=playlist")
void searchPlaylists(@Query(value="q")
String q,
retrofit.Callback<PlaylistsPager> callback)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"callback - Callback method@GET(value="/search?type=playlist") PlaylistsPager searchPlaylists(@Query(value="q") String q)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"@GET(value="/search?type=playlist")
void searchPlaylists(@Query(value="q")
String q,
@QueryMap
Map<String,Object> options,
retrofit.Callback<PlaylistsPager> callback)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"options - Optional parameters. For list of supported parameters see
endpoint documentationcallback - Callback method.@GET(value="/search?type=playlist") PlaylistsPager searchPlaylists(@Query(value="q") String q, @QueryMap Map<String,Object> options)
q - The search query's keywords (and optional field filters and operators), for example "roadhouse+blues"options - Optional parameters. For list of supported parameters see
endpoint documentation@GET(value="/audio-features")
void getTracksAudioFeatures(@Query(value="ids")
String ids,
retrofit.Callback<AudioFeaturesTracks> callback)
ids - A comma-separated list of the Spotify IDs for the tracks. Maximum: 100 IDscallback - Callback method@GET(value="/audio-features") AudioFeaturesTracks getTracksAudioFeatures(@Query(value="ids") String ids)
ids - A comma-separated list of the Spotify IDs for the tracks. Maximum: 100 IDs@GET(value="/audio-features/{id}")
void getTrackAudioFeatures(@Path(value="id")
String id,
retrofit.Callback<AudioFeaturesTrack> callback)
id - The Spotify ID for the track.callback - Callback method@GET(value="/audio-features/{id}")
AudioFeaturesTrack getTrackAudioFeatures(@Path(value="id")
String id)
id - The Spotify ID for the track.@GET(value="/recommendations") Recommendations getRecommendations(@QueryMap Map<String,Object> options)
options - Optional parameters. For list of available parameters see
endpoint documentation@GET(value="/recommendations")
void getRecommendations(@QueryMap
Map<String,Object> options,
retrofit.Callback<Recommendations> callback)
options - Optional parameters. For list of available parameters see
endpoint documentationcallback - callback method@GET(value="/recommendations/available-genre-seeds") SeedsGenres getSeedsGenres()
@GET(value="/recommendations/available-genre-seeds") void getSeedsGenres(retrofit.Callback<SeedsGenres> callback)
callback - callback method@GET(value="/me/top/artists") Pager<Artist> getTopArtists()
@GET(value="/me/top/artists") void getTopArtists(retrofit.Callback<Pager<Artist>> callback)
callback - callback method@GET(value="/me/top/artists") Pager<Artist> getTopArtists(@QueryMap Map<String,Object> options)
options - Optional parameters. For list of available parameters see
endpoint documentation@GET(value="/me/top/artists")
void getTopArtists(@QueryMap
Map<String,Object> options,
retrofit.Callback<Pager<Artist>> callback)
options - Optional parameters. For list of available parameters see
endpoint documentationcallback - Callback method@GET(value="/me/top/tracks") Pager<Track> getTopTracks()
@GET(value="/me/top/tracks") void getTopTracks(retrofit.Callback<Pager<Track>> callback)
callback - callback method@GET(value="/me/top/tracks") Pager<Track> getTopTracks(@QueryMap Map<String,Object> options)
options - Optional parameters. For list of available parameters see
endpoint documentation@GET(value="/me/top/tracks")
void getTopTracks(@QueryMap
Map<String,Object> options,
retrofit.Callback<Pager<Track>> callback)
options - Optional parameters. For list of available parameters see
endpoint documentationcallback - Callback method