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
- localestring
The desired language, consisting of an ISO 639-1 language code and an 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 category strings returned in a particular language.
Note: iflocale
is not supplied, or if the specified language is not available, the category strings returned will be in the Spotify default language (American English).Example:locale=sv_SE
- limitinteger
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Default:limit=20
Range:0
-50
Example:limit=10
- offsetinteger
The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
Default:offset=0
Example:offset=5
Response
A paged set of playlists
- messagestring
The localized message of a playlist.
Example:"Popular Playlists"
- hrefstringRequired
A link to the Web API endpoint returning the full result of the request
Example:"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:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example:"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:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example:4
- Required
Response sample
{ "message": "Popular Playlists", "playlists": { "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20", "limit": 20, "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "offset": 0, "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "total": 4, "items": [ { "collaborative": false, "description": "string", "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "name": "string", "owner": { "external_urls": { "spotify": "string" }, "followers": { "href": "string", "total": 0 }, "href": "string", "id": "string", "type": "user", "uri": "string", "display_name": "string" }, "public": false, "snapshot_id": "string", "tracks": { "href": "string", "total": 0 }, "type": "string", "uri": "string" } ] }}