Secure your code as it's written. Use Snyk Code to scan source code in minutes - no build needed - and fix issues immediately.
@maximise_limit(50)
def categories(
self,
country: str = None,
locale: str = None,
limit: int = 20,
offset: int = 0
) -> CategoryPaging:
"""
Get a list of categories used to tag items in Spotify.
Parameters
----------
country
an ISO 3166-1 alpha-2 country code
locale
the desired language, consisting of a lowercase ISO 639 language code
@maximise_limit(50)
def artist_albums(
self,
artist_id: str,
include_groups: List[Union[str, AlbumGroup]] = None,
market: str = None,
limit: int = 20,
offset: int = 0
) -> SimpleAlbumPaging:
"""
Get an artist's albums.
Parameters
----------
artist_id
the artist ID
include_groups
@maximise_limit(50)
def playback_recently_played(
self,
limit: int = 20,
after: int = None,
before: int = None
) -> PlayHistoryPaging:
"""
Get tracks from the current user's recently played tracks.
Only ``after`` or ``before`` should be specified at one time.
Parameters
----------
limit
the number of items to return (1..50)
after
@maximise_limit(50)
def show_episodes(
self,
show_id: str,
market: str = None,
limit: int = 20,
offset: int = 0
) -> SimpleEpisodePaging:
"""
Get episodes of a show.
Parameters
----------
show_id
show ID
market
an ISO 3166-1 alpha-2 country code.
@maximise_limit(50)
def saved_tracks(
self,
market: str = None,
limit: int = 20,
offset: int = 0
) -> SavedTrackPaging:
"""
Get the songs saved in the current user's library.
Parameters
----------
market
an ISO 3166-1 alpha-2 country code or 'from_token'
limit
the number of items to return (1..50)
offset
@maximise_limit(50)
def current_user_top_tracks(
self,
time_range: str = 'medium_term',
limit: int = 20,
offset: int = 0
) -> FullTrackPaging:
"""
Get the current user's top tracks.
Parameters
----------
time_range
Over what time frame are the affinities computed.
Valid-values: short_term, medium_term, long_term
limit
the number of items to return (1..50)
@maximise_limit(50)
def category_playlists(
self,
category_id: str,
country: str = None,
limit: int = 20,
offset: int = 0
) -> SimplePlaylistPaging:
"""
Get a list of Spotify playlists tagged with a particular category.
Parameters
----------
category_id
category ID
country
an ISO 3166-1 alpha-2 country code
@maximise_limit(50)
def playlists(
self,
user_id: str,
limit: int = 20,
offset: int = 0
) -> SimplePlaylistPaging:
"""
Get a list of the playlists owned or followed by a user.
Collaborative playlists are only returned for the current user.
Parameters
----------
user_id
user ID
limit
@maximise_limit(50)
def followed_playlists(
self,
limit: int = 20,
offset: int = 0
) -> SimplePlaylistPaging:
"""
Get a list of the playlists owned or followed by the current user.
Parameters
----------
limit
the number of items to return (1..50)
offset
the index of the first item to return
"""
return self._get('me/playlists', limit=limit, offset=offset)
@maximise_limit(50)
def saved_shows(
self,
market: str = None,
limit: int = 20,
offset: int = 0
) -> SavedShowPaging:
"""
Get the shows saved in the current user's library.
Parameters
----------
market
an ISO 3166-1 alpha-2 country code or 'from_token'
limit
the number of items to return (1..50)
offset