Library
Get User's Top Artists
Get the current user's top artists based on calculated affinity.
Authorization
oauth_2_0 user-top-readAuthorizationBearer <token>
Spotify supports OAuth 2.0 for authenticating all API requests.
In: header
Scope: user-top-read
Query Parameters
time_range?Time Range
Over what time frame the affinities are computed. Valid values: long_term (calculated from ~1 year 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
Default
"medium_term"limit?Limit
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Range
1 <= value <= 50Default
20offset?Offset
The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
Default
0Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/me/top/artists"{ "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20\n", "limit": 20, "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "offset": 0, "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "total": 4, "items": [ { "external_urls": { "spotify": "string" }, "followers": { "href": "string", "total": 0 }, "genres": [ "Prog rock", "Grunge" ], "href": "string", "id": "string", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n", "height": 300, "width": 300 } ], "name": "string", "popularity": 0, "type": "artist", "uri": "string" } ]}