v1

latestOpenAPI 3.0.32026-07-148993228.8 KB

Playlists

Get Category's Playlists

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

get/browse/categories/{category_id}/playlists

Path parameters

category_idstring required

The Spotify category ID for the category.

Example:dinner

Query parameters

countrystring

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

Example:SE

limitinteger

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

Example:10

offsetinteger

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

Example:5

Response

A paged set of playlists

messagestring

Example response

{
  "playlists": {
    "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20\n",
    "limit": 20,
    "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",
    "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",
    "total": 4,
    "items": [
      {
        "images": [
          {
            "height": 300,
            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
            "width": 300
          }
        ]
      }
    ]
  }
}