Get User's Top Items
Get the current user's top artists or tracks based on calculated affinity.
Read your top artists and content.
Request
- typestringRequired
The type of entity to return. Valid values:
artists
ortracks
Allowed values:"artists"
,"tracks"
- time_rangestring
Over what time frame the affinities are computed. Valid values:
long_term
(calculated from several years of data and including all new data as it becomes available),medium_term
(approximately last 6 months),short_term
(approximately last 4 weeks). Default:medium_term
Example value:"medium_term"
Default value:"medium_term"
- limitinteger
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Example value:10
Default value:20
Range:0
-50
- offsetinteger
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:5
Default value:0
Response
Pages of artists or tracks
- hrefstringRequired
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"
- limitintegerRequired
The maximum number of items in the response (as set in the query or by default).
Example value:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example value:"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 value:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example value:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example value:4
- itemsarray of oneOfsRequiredWill be one of the following: