Get a Category's Playlists

GET

/browse/categories/{category_id}/playlists

Get a list of Spotify playlists tagged with a particular category.

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

200 - 示例 1

{
    "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
    }
}

请求参数

Path 参数

category_id

必需

The Spotify category ID for the category.

Query 参数

country

可选

A country: an ISO 3166-1 alpha-2 country code. Provide this parameter to ensure that the category exists for a particular country.

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 an array of simplified [playlist objects](https://developer.spotify.com/documentation/web-api/reference/#object-simplifiedplaylistobject) (wrapped in a [pag

application/json

Body

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

Get All Featured Playlists