Search + K

Command Palette

Search for a command to run...

Sign In

Get User's Top Items

GET /me/top/{type}
Copy endpoint
https://api.spotify.com/v1

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

Parameters

path Path Parameters

Name Type
type required
"artists" | "tracks"

query Query Parameters

Name Type
time_range
string
limit
number
offset
number

Responses

200 application/json

Pages of artists or tracks

never

Client Errors

401 application/json

Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
403 application/json

Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
429 application/json

The app has exceeded its rate limits.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }