Spotify Web API

Get a Category's Playlists

Developing

GET

/browse/categories/{category_id}/playlists

category-browse

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

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 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
  }
}

Request

Path Params

category_id

string

required

The Spotify category ID for the category.

Query Params

country

string

optional

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

limit

integer

optional

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

offset

integer

optional

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

Header Params

Authorization

string

required

A valid user access token or your client credentials.

Responses

🟢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

optional

href

string

optional

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

items

array[object (SimplifiedPlaylistObject) {13}]

optional

The requested data.

limit

integer <int32>

optional

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

string

optional

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

offset

integer <int32>

optional

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

string

optional

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

total

integer <int32>

optional

The total number of items available to return.

🔴500500

Modified at 2022-09-12 10:04:50

Get a Category

Get All Featured Playlists