Get Featured Playlists
Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab).
Please keep in mind that you can not enable transfers of data to another service, except for the purpose of enabling a user to transfer their personal data or the metadata of the user's playlists to another service.
More information
Request
- countrystring
A country: an ISO 3166-1 alpha-2 country code. Provide this parameter if you want the list of returned items to be relevant to a particular country. If omitted, the returned items will be relevant to all countries.
Example value:"SE"
- localestring
The desired language, consisting of a lowercase ISO 639-1 language code and an uppercase ISO 3166-1 alpha-2 country code, joined by an underscore. For example:
es_MX
, meaning "Spanish (Mexico)". Provide this parameter if you want the results returned in a particular language (where available).
Note: iflocale
is not supplied, or if the specified language is not available, all strings will be returned in the Spotify default language (American English). Thelocale
parameter, combined with thecountry
parameter, may give odd results if not carefully matched. For examplecountry=SE&locale=de_DE
will return a list of categories relevant to Sweden but as German language strings.Example value:"sv_SE"
- timestampstring
A timestamp in ISO 8601 format:
yyyy-MM-ddTHH:mm:ss
. Use this parameter to specify the user's local time to get results tailored for that specific date and time in the day. If not provided, the response defaults to the current UTC time. Example: "2014-10-23T09:00:00" for a user whose local time is 9AM. If there were no featured playlists (or there is no data) at the specified time, the response will revert to the current UTC time.Example value:"2014-10-23T09:00:00"
- limitinteger
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Example value:10
Default value:20
Range:0
-50
- offsetinteger
The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
Example value:5
Default value:0
Response
A paged set of playlists
- messagestring
- hrefstringRequired
A link to the Web API endpoint returning the full result of the request
Example value:"https://api.spotify.com/v1/me/shows?offset=0&limit=20"
- limitintegerRequired
The maximum number of items in the response (as set in the query or by default).
Example value:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example value:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- offsetintegerRequired
The offset of the items returned (as set in the query or by default)
Example value:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example value:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example value:4
- Required