Get a Category

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

Endpoint

GET https://api.spotify.com/v1/browse/categories/{category_id}

Request Parameters

Path parameter	Value
category_id	The Spotify category ID for the category.

Header field	Value
Authorization	Required. A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details.

Query parameter Value

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

locale Optional. The desired language, consisting of an ISO 639 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 that, 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).

Query parameter	Value
country	Optional. A country: an ISO 3166-1 alpha-2 country code. Provide this parameter to ensure that the category exists for a particular country.
locale	Optional. The desired language, consisting of an ISO 639 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 that, 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).

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains a category object in JSON format. On error, the header status code is an error code and the response body contains an error object.

Once you have retrieved the category, you can use Get a Category’s Playlists to drill down further.

Example

curl -i -X GET "https://api.spotify.com/v1/browse/categories/party" -H "Authorization: Bearer {your access token}"

{
  "href" : "https://api.spotify.com/v1/browse/categories/party",
  "icons" : [ {
    "height" : 274,
    "url" : "https://datsnxq1rwndn.cloudfront.net/media/derived/party-274x274_73d1907a7371c3bb96a288390a96ee27_0_0_274_274.jpg",
    "width" : 274
  } ],
  "id" : "party",
  "name" : "Party"
}

Try it in our Web API Console

category object (full)

Key	Value Type	Value Description
href	string	A link to the Web API endpoint returning full details of the category.
icons	an array of image objects	The category icon, in various sizes.
id	string	The Spotify category ID of the category.
name	string	The name of the category.

Newsletter