---
title: "Get User's Top Artists"
method: GET
path: "/me/top/artists"
tags: ["Users", "Artists", "Library"]
---

# Get User's Top Artists

`GET /me/top/artists`

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

## Query parameters

- `time_range` string — 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 — The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
- `offset` integer — The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.

## Response `200`

Pages of artists

- PagingArtistObject
  - `href` string, required — A link to the Web API endpoint returning the full result of the request
  - `limit` integer, required — The maximum number of items in the response (as set in the query or by default).
  - `next` string, nullable, required — URL to the next page of items. ( `null` if none)
  - `offset` integer, required — The offset of the items returned (as set in the query or by default)
  - `previous` string, nullable, required — URL to the previous page of items. ( `null` if none)
  - `total` integer, required — The total number of items available to return.
  - `items` ArtistObject[], required
    - `external_urls` ExternalUrlObject
      - `spotify` string — The [Spotify URL](/documentation/web-api/#spotify-uris-and-ids) for the object.
    - `followers` FollowersObject
      - `href` string, nullable — This will always be set to null, as the Web API does not support it at the moment.
      - `total` integer — The total number of followers.
    - `genres` string[] — A list of the genres the artist is associated with. If not yet classified, the array is empty.
    - `href` string — A link to the Web API endpoint providing full details of the artist.
    - `id` string — The [Spotify ID](/documentation/web-api/#spotify-uris-and-ids) for the artist.
    - `images` ImageObject[] — Images of the artist in various sizes, widest first.
      - `height` integer, nullable, required — The image height in pixels.
      - `url` string, required — The source URL of the image.
      - `width` integer, nullable, required — The image width in pixels.
    - `name` string — The name of the artist.
    - `popularity` integer — The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist's popularity is calculated from the popularity of all the artist's tracks.
    - `type` 'artist' — The object type.
    - `uri` string — The [Spotify URI](/documentation/web-api/#spotify-uris-and-ids) for the artist.

## Other responses

- `401` — 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.
- `403` — Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.
- `429` — The app has exceeded its rate limits.

---

[API](https://skmtc.net/spotify/apis/sonallux.md) · [All operations](https://skmtc.net/spotify/apis/sonallux/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotify/sonallux/versions/1459b27f2e48/schema)