--- title: "Get Featured Playlists" method: GET path: "/browse/featured-playlists" tags: ["Playlists"] --- # Get Featured Playlists `GET /browse/featured-playlists` Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab). ## Query parameters - `country` string — A country: an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). 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. - `locale` string — The desired language, consisting of a lowercase [ISO 639-1 language code](http://en.wikipedia.org/wiki/ISO_639-1) and an uppercase [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), 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**: if `locale` is not supplied, or if the specified language is not available, all strings will be returned in the Spotify default language (American English). The `locale` parameter, combined with the `country` parameter, may give odd results if not carefully matched. For example `country=SE&locale=de_DE` will return a list of categories relevant to Sweden but as German language strings._ - `timestamp` string — A timestamp in [ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601): `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. - `limit` integer — The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. - `offset` integer — The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items. ## Response `200` A paged set of playlists - PagingFeaturedPlaylistObject - `message` string - `playlists` PagingPlaylistObject - `href` string, required — A link to the Web API endpoint returning the full result of the request - `limit` integer, required — The maximum number of items in the response (as set in the query or by default). - `next` string, nullable, required — URL to the next page of items. ( `null` if none) - `offset` integer, required — The offset of the items returned (as set in the query or by default) - `previous` string, nullable, required — URL to the previous page of items. ( `null` if none) - `total` integer, required — The total number of items available to return. - `items` SimplifiedPlaylistObject[], required - `collaborative` boolean — `true` if the owner allows other users to modify the playlist. - `description` string — The playlist description. _Only returned for modified, verified playlists, otherwise_ `null`. - `external_urls` ExternalUrlObject - `spotify` string — The [Spotify URL](/documentation/web-api/#spotify-uris-and-ids) for the object. - `href` string — A link to the Web API endpoint providing full details of the playlist. - `id` string — The [Spotify ID](/documentation/web-api/#spotify-uris-and-ids) for the playlist. - `images` ImageObject[] — Images for the playlist. The array may be empty or contain up to three images. The images are returned by size in descending order. See [Working with Playlists](/documentation/general/guides/working-with-playlists/). _**Note**: If returned, the source URL for the image (`url`) is temporary and will expire in less than a day._ - `height` integer, nullable, required — The image height in pixels. - `url` string, required — The source URL of the image. - `width` integer, nullable, required — The image width in pixels. - `name` string — The name of the playlist. - `owner` PlaylistOwnerObject - `external_urls` ExternalUrlObject - `spotify` string — The [Spotify URL](/documentation/web-api/#spotify-uris-and-ids) for the object. - `followers` FollowersObject - `href` string, nullable — This will always be set to null, as the Web API does not support it at the moment. - `total` integer — The total number of followers. - `href` string — A link to the Web API endpoint for this user. - `id` string — The [Spotify user ID](/documentation/web-api/#spotify-uris-and-ids) for this user. - `type` 'user' — The object type. - `uri` string — The [Spotify URI](/documentation/web-api/#spotify-uris-and-ids) for this user. - `display_name` string, nullable — The name displayed on the user's profile. `null` if not available. - `public` boolean — The playlist's public/private status: `true` the playlist is public, `false` the playlist is private, `null` the playlist status is not relevant. For more about public/private status, see [Working with Playlists](/documentation/general/guides/working-with-playlists/) - `snapshot_id` string — The version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version - `tracks` PlaylistTracksRefObject - `href` string — A link to the Web API endpoint where full details of the playlist's tracks can be retrieved. - `total` integer — Number of tracks in the playlist. - `type` string — The object type: "playlist" - `uri` string — The [Spotify URI](/documentation/web-api/#spotify-uris-and-ids) for the playlist. ## Other responses - `401` — Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user. - `403` — Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here. - `429` — The app has exceeded its rate limits. --- [API](https://skmtc.net/spotify/apis/sonallux.md) · [All operations](https://skmtc.net/spotify/apis/sonallux/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotify/sonallux/versions/1459b27f2e48/schema)