Artists

Get User's Top Artists

GET
/me/top/artists

Get the current user's top artists based on calculated affinity.

Authorization

oauth_2_0 user-top-read
AuthorizationBearer <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.

Range1 <= value <= 50
Default20
offset?Offset

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

Default0

Response 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"    }  ]}