Skip to content
Web API •References / Playlists / Get Category's Playlists

Get Category's Playlists

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

Request

  • category_id
    string
    Required

    The Spotify category ID for the category.

    Example: dinner
  • limit
    integer

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

    Default: limit=20Range: 0 - 50Example: limit=10
  • offset
    integer

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

    Default: offset=0Example: offset=5

Response

A paged set of playlists

  • message
    string

    The localized message of a playlist.

    Example: "Popular Playlists"
    • href
      string
      Required

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

      Example: "https://api.spotify.com/v1/me/shows?offset=0&limit=20"
    • limit
      integer
      Required

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

      Example: 20
    • next
      string
      Required
      Nullable

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

      Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
    • offset
      integer
      Required

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

      Example: 0
    • previous
      string
      Required
      Nullable

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

      Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
    • total
      integer
      Required

      The total number of items available to return.

      Example: 4
    • Required
      • collaborative
        boolean

        true if the owner allows other users to modify the playlist.

      • description
        string

        The playlist description. Only returned for modified, verified playlists, otherwise null.

      • Known external URLs for this playlist.

      • href
        string

        A link to the Web API endpoint providing full details of the playlist.

      • id
        string

        The Spotify ID for the playlist.

      • Images for the playlist. The array may be empty or contain up to three images. The images are returned by size in descending order. See Working with Playlists. Note: If returned, the source URL for the image (url) is temporary and will expire in less than a day.

        • url
          string
          Required

          The source URL of the image.

          Example: "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
        • height
          integer
          Required
          Nullable

          The image height in pixels.

          Example: 300
        • width
          integer
          Required
          Nullable

          The image width in pixels.

          Example: 300
      • name
        string

        The name of the playlist.

      • The user who owns the playlist

        • Known public external URLs for this user.

        • Information about the followers of this user.

          • href
            string
            Nullable

            This will always be set to null, as the Web API does not support it at the moment.

          • total
            integer

            The total number of followers.

        • href
          string

          A link to the Web API endpoint for this user.

        • id
          string

          The Spotify user ID for this user.

        • type
          string

          The object type.

          Allowed values: "user"
        • uri
          string

          The Spotify URI for this user.

        • display_name
          string
          Nullable

          The name displayed on the user's profile. null if not available.

      • public
        boolean

        The playlist's public/private status (if it is added to the user's profile): true the playlist is public, false the playlist is private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

      • snapshot_id
        string

        The version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version

      • A collection containing a link ( href ) to the Web API endpoint where full details of the playlist's tracks can be retrieved, along with the total number of tracks in the playlist. Note, a track object may be null. This can happen if a track is no longer available.

        • href
          string

          A link to the Web API endpoint where full details of the playlist's tracks can be retrieved.

        • total
          integer

          Number of tracks in the playlist.

      • type
        string

        The object type: "playlist"

      • uri
        string

        The Spotify URI for the playlist.

endpointhttps://api.spotify.com/v1/browse/categories/{category_id}/playlistscategory_idlimitoffset

Response sample

{  "message": "Popular Playlists",  "playlists": {    "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20",    "limit": 20,    "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",    "offset": 0,    "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",    "total": 4,    "items": [      {        "collaborative": false,        "description": "string",        "external_urls": {          "spotify": "string"        },        "href": "string",        "id": "string",        "images": [          {            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228",            "height": 300,            "width": 300          }        ],        "name": "string",        "owner": {          "external_urls": {            "spotify": "string"          },          "followers": {            "href": "string",            "total": 0          },          "href": "string",          "id": "string",          "type": "user",          "uri": "string",          "display_name": "string"        },        "public": false,        "snapshot_id": "string",        "tracks": {          "href": "string",          "total": 0        },        "type": "string",        "uri": "string"      }    ]  }}