Endpoint

GET https://api.spotify.com/v1/me/following?type=artist

Request Parameters

Header Fields

Header Field Value
Authorization 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 the artists or users the current user follows requires authorization of the user-follow-read scope. See Using Scopes.

Query Parameters

Query Parameter Value
type Required. The ID type: currently only artist is supported.
limit Optional. The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
after Optional. The last artist ID retrieved from the previous request.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains an artists object. The artists object in turn contains a cursor-based paging object of Artists. On error, the header status code is an error code and the response body contains an error object.

Examples

Get the current user’s followed artists

curl -X GET "https://api.spotify.com/v1/me/following?type=artist" -H "Authorization: Bearer {your access token}"
{
  "artists" : {
    "items" : [ {
      "external_urls" : {
        "spotify" : "https://open.spotify.com/artist/0I2XqVXqHScXjHhk6AYYRe"
      },
      "followers" : {
        "href" : null,
        "total" : 7753
      },
      "genres" : [ "swedish hip hop" ],
      "href" : "https://api.spotify.com/v1/artists/0I2XqVXqHScXjHhk6AYYRe",
      "id" : "0I2XqVXqHScXjHhk6AYYRe",
      "images" : [ {
        "height" : 640,
        "url" : "https://i.scdn.co/image/2c8c0cea05bf3d3c070b7498d8d0b957c4cdec20",
        "width" : 640
      }, {
        "height" : 300,
        "url" : "https://i.scdn.co/image/394302b42c4b894786943e028cdd46d7baaa29b7",
        "width" : 300
      }, {
        "height" : 64,
        "url" : "https://i.scdn.co/image/ca9df7225ade6e5dfc62e7076709ca3409a7cbbf",
        "width" : 64
      } ],
      "name" : "Afasi & Filthy",
      "popularity" : 54,
      "type" : "artist",
      "uri" : "spotify:artist:0I2XqVXqHScXjHhk6AYYRe"
   },{
     ...
   }],
  "next" : "https://api.spotify.com/v1/users/thelinmichael/following?type=artist&after=0aV6DOiouImYTqrR5YlIqx&limit=20",
  "total" : 183,
    "cursors" : {
      "after" : "0aV6DOiouImYTqrR5YlIqx"
    },
   "limit" : 20,
   "href" : "https://api.spotify.com/v1/users/thelinmichael/following?type=artist&limit=20"
  }
}

Try it

Get the current user’s followed artists using cursor

Get the next page of results using the after cursor in the previous response:

curl -X GET "https://api.spotify.com/v1/me/following?type=artist&after=0aV6DOiouImYTqrR5YlIqx" -H "Authorization: Bearer {your access token}"
{
  "artists" : {
    "items" : [ {
      "external_urls" : {
        "spotify" : "https://open.spotify.com/artist/01SvE1zJxDTFdcL7UMd0rv"
      },
      "followers" : {
        "href" : null,
        "total" : 404
      },
      "genres" : [ ],
      "href" : "https://api.spotify.com/v1/artists/01SvE1zJxDTFdcL7UMd0rv",
      "id" : "01SvE1zJxDTFdcL7UMd0rv",
      "images" : [ ],
      "name" : "Pst/Q",
      "popularity" : 32,
      "type" : "artist",
      "uri" : "spotify:artist:01SvE1zJxDTFdcL7UMd0rv"
    },{
      ...
    }],
    "next" : "https://api.spotify.com/v1/users/thelinmichael/following?type=artist&after=0aV6DOiouImYTqrR5YlIqx&limit=20",
    "total" : 183,
    "cursors" : {
      "after" : "0aV6DOiouImYTqrR5YlIqx"
    },
    "limit" : 20,
    "href" : "https://api.spotify.com/v1/users/thelinmichael/following?type=artist&limit=20"
  }
}

artist (full)

Key Value Type Value Description
external_urls an external URL object Known external URLs for this artist.
followers A followers object Information about the followers of the artist.
genres array of strings A list of the genres the artist is associated with. For example: "Prog Rock" , "Post-Grunge". (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 for the artist.
images array of image objects Images of the artist in various sizes, widest first.
name string The name of the artist
popularity int 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 string The object type: "artist"
uri string The Spotify URI for the artist.

cursor-based paging object

Key Value Type Value Description
href string A link to the Web API endpoint returning the full result of the request.
items an array of objects The requested data.
limit integer The maximum number of items in the response (as set in the query or by default).
next string URL to the next page of items. ( null if none)
cursors cursor object The cursors used to find the next set of items.
total integer The total number of items available to return.