Skip to content
DocumentationAPI Reference

Get Single Browse Category

CategoryRetrieveResponse Browse.Categories.Retrieve(CategoryRetrieveParamsparameters, CancellationTokencancellationToken = default)
GET/browse/categories/{category_id}

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

ParametersExpand Collapse
CategoryRetrieveParams parameters
required string categoryID

The Spotify category ID for the category.

string locale

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).

ReturnsExpand Collapse
class CategoryRetrieveResponse:
required string ID

The Spotify category ID of the category.

required string Href

A link to the Web API endpoint returning full details of the category.

required IReadOnlyList<ImageObject> Icons

The category icon, in various sizes.

required Long? Height

The image height in pixels.

required string Url

The source URL of the image.

required Long? Width

The image width in pixels.

Boolean Published

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

required string Name

The name of the category.

Boolean Published

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

Get Single Browse Category

CategoryRetrieveParams parameters = new() { CategoryID = "dinner" };

var category = await client.Browse.Categories.Retrieve(parameters);

Console.WriteLine(category);
{
  "id": "equal",
  "href": "href",
  "icons": [
    {
      "height": 300,
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "width": 300,
      "published": true
    }
  ],
  "name": "EQUAL",
  "published": true
}
Returns Examples
{
  "id": "equal",
  "href": "href",
  "icons": [
    {
      "height": 300,
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "width": 300,
      "published": true
    }
  ],
  "name": "EQUAL",
  "published": true
}