Skip to content
Announcement:We are updating the criteria to be granted extended access to the Web API.
Please note that starting May 15, 2025 we’re introducing some changes to the way we provide Web API extended quota mode access. For more information, read here.
Web APIReferences / Categories / Get Single Browse Category

Get Single Browse Category

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

Request

  • category_id
    string
    Required

    The Spotify category ID for the category.

    Example: dinner
  • 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

Response

A category

  • 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"
endpointhttps://api.spotify.com/v1/browse/categories/{category_id}category_idlocale

Response sample

{  "href": "string",  "icons": [    {      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228",      "height": 300,      "width": 300    }  ],  "id": "equal",  "name": "EQUAL"}