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
- countrystring
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:country=SE
- localestring
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: iflocale
is not supplied, or if the specified language is not available, all strings will be returned in the Spotify default language (American English). Thelocale
parameter, combined with thecountry
parameter, may give odd results if not carefully matched. For examplecountry=SE&locale=de_DE
will return a list of categories relevant to Sweden but as German language strings.Example:locale=sv_SE
- limitinteger
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Default:limit=20
Range:0
-50
Example:limit=10
- offsetinteger
The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
Default:offset=0
Example:offset=5
Response
A paged set of categories
- Required
- hrefstringRequired
A link to the Web API endpoint returning the full result of the request
Example:"https://api.spotify.com/v1/me/shows?offset=0&limit=20"
- limitintegerRequired
The maximum number of items in the response (as set in the query or by default).
Example:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- offsetintegerRequired
The offset of the items returned (as set in the query or by default)
Example:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example:4