Web API •References / Categories / Get Several Browse Categories

Get Several Browse Categories

Get a list of categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).

Request

locale
string
The desired language, consisting of an ISO 639-1 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore. For example: es_MX, meaning "Spanish (Mexico)". Provide this parameter if you want the category strings returned in a particular language.
Note: if locale is not supplied, or if the specified language is not available, the category strings returned will be in the Spotify default language (American English).
Example: locale=sv_SE
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 categories

Required
- 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
  href
  string
  Required
  A link to the Web API endpoint returning full details of the category.
  Required
  The category icon, in various sizes.
  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
  id
  string
  Required
  The Spotify category ID of the category.
  Example: "equal"
  name
  string
  Required
  The name of the category.
  Example: "EQUAL"

Response sample

{  "categories": {    "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": [      {        "href": "string",        "icons": [          {            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228",            "height": 300,            "width": 300          }        ],        "id": "equal",        "name": "EQUAL"      }    ]  }}