Get All Featured Playlists

GET

/browse/featured-playlists

category-browse

Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab).

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/browse/featured-playlists' \
--header 'Authorization;'

响应示例

200 - 示例 1

{
  "message": "string",
  "playlists": {
    "href": "string",
    "items": [
      {
        "collaborative": true,
        "description": "string",
        "external_urls": {
          "spotify": "string"
        },
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 0,
            "url": "string",
            "width": 0
          }
        ],
        "name": "string",
        "owner": {
          "display_name": "string",
          "external_urls": {
            "spotify": "string"
          },
          "followers": {
            "href": "string",
            "total": 0
          },
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 0,
              "url": "string",
              "width": 0
            }
          ],
          "type": "string",
          "uri": "string"
        },
        "public": true,
        "snapshot_id": "string",
        "tracks": {
          "href": "string",
          "total": 0
        },
        "type": "string",
        "uri": "string"
      }
    ],
    "limit": 0,
    "next": "string",
    "offset": 0,
    "previous": "string",
    "total": 0
  }
}

请求参数

Query 参数

country

可选

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.

locale

可选

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 that, 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

可选

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.

limit

可选

The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

offset

可选

The index of the first item to return. Default: 0 (the first object). Use with limit to get the next set of items.

Header 参数

Authorization

必需

A valid user access token or your client credentials.

返回响应

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains a `message` and a `playlists` object. The `playlists` object contains an array of simplified [playlist objects](https://developer.spotify.com/documentation/

application/json

Body

message

string

可选

playlists

object

可选

href

string

可选

A link to the Web API endpoint returning the full result of the request

items

array[object (SimplifiedPlaylistObject) {13}]

可选

The requested data.

limit

integer <int32>

可选

The maximum number of items in the response (as set in the query or by default).

string

可选

URL to the next page of items. ( null if none)

offset

integer <int32>

可选

The offset of the items returned (as set in the query or by default)

string

可选

URL to the previous page of items. ( null if none)

total

integer <int32>

可选

The total number of items available to return.

🔴500500

修改于 2021-08-02 10:49:33

Get a Category's Playlists

Get All New Releases