Get All Categories

GET

/browse/categories

category-browse

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/browse/categories' \
--header 'Authorization;'

响应示例

200 - 示例 1

{
  "categories": {
    "href": "string",
    "items": [
      {
        "href": "string",
        "icons": [
          {
            "height": 0,
            "url": "string",
            "width": 0
          }
        ],
        "id": "string",
        "name": "string"
      }
    ],
    "limit": 0,
    "next": "string",
    "offset": 0,
    "previous": "string",
    "total": 0
  }
}

请求参数

Query 参数

country

可选

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.

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 metadata returned in a particular language. Note that, 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.

limit

可选

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

offset

可选

The index of the first item to return. Default: 0 (the first object). Use with limit to get the next set of categories.

Header 参数

Authorization

必需

A valid user access token or your client credentials.

返回响应

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains an object with a `categories` field, with an array of [category objects](#categoryobject) (wrapped in a [paging object](https://developer.spotify.com/docume

application/json

Body