Skip to content
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

  • country
    string

    A country: an ISO 3166-1 alpha-2 country code. Provide this parameter if you want to narrow the list of returned categories to those relevant to a particular country. If omitted, the returned items will be globally relevant.

    Example value: "SE"
  • 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 metadata returned in a particular language.
    Note: if locale is not supplied, or if the specified language is not available, all strings will be returned in the Spotify default language (American English). The locale parameter, combined with the country parameter, may give odd results if not carefully matched. For example country=SE&locale=de_DE will return a list of categories relevant to Sweden but as German language strings.

    Example value: "sv_SE"
  • limit
    integer

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

    Example value: 10Default value: 20Range: 0 - 50
  • 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.

    Example value: 5Default value: 0

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 value: "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 value: 20
    • next
      string
      Required
      Nullable

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

      Example value: "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 value: 0
    • previous
      string
      Required
      Nullable

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

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

      The total number of items available to return.

      Example value: 4