Get a User's Top Artists and Tracks

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

{ "href": "string", "items": [ { "external_urls": { "spotify": "string" }, "followers": { "href": "string", "total": 0 }, "genres": [ "string" ], "href": "string", "id": "string", "images": [ { "height": 0, "url": "string", "width": 0 } ], "name": "string", "popularity": 0, "type": "string", "uri": "string" } ], "limit": 0, "next": "string", "offset": 0, "previous": "string", "total": 0 }

Request

Path Params

type

string

required

The type of entity to return. Valid values: artists or tracks

Query Params

time_range

string

optional

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

limit

integer

optional

The number of entities to return. Default: 20. Minimum: 1. Maximum: 50. For example: limit=2

offset

integer

optional

The index of the first entity to return. Default: 0 (i.e., the first track). Use with limit to get the next set of entities.

Header Params

Authorization

string

required

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the current user.
Getting details of a user's top artists and tracks requires authorization of the user-top-read scope. See Using Scopes.

Responses

🟢200On success, the HTTP status code in the response header is `200 OK` and the response body contains a [paging object](https://developer.spotify.com/documentation/web-api/reference/#object-pagingobject) of [Artists](https://developer.spotify.com/documentati

application/json

Body

href

string

optional

A link to the Web API endpoint returning the full result of the request

items

array [oneOf]

optional

The requested data.

object (ArtistObject)

optional

object (TrackObject)

optional

limit

integer <int32>

optional

The maximum number of items in the response (as set in the query or by default).

string

optional

URL to the next page of items. ( null if none)

offset

integer <int32>

optional

The offset of the items returned (as set in the query or by default)

string

optional

URL to the previous page of items. ( null if none)

total

integer <int32>

optional

The total number of items available to return.

🔴500500