Spotify Web API

Get a Category's Playlists

GET

/browse/categories/{category_id}/playlists

category-browse

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

Get a Category

Get All Featured Playlists