Spotify Web API

Get User's Followed Artists

Developing

GET

/me/following

category-follow

Get the current user's followed artists.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/me/following?type=' \
--header 'Authorization;'

Response Example

200 - Example 1

{
  "artists": {
    "cursors": {
      "after": "string"
    },
    "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",
    "total": 0
  }
}

Request

Query Params

type

string

required

The ID type: currently only artist is supported.

after

string

optional

The last artist ID retrieved from the previous request.

limit

integer

optional

The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

Header Params

Authorization

string

required

A valid user access token or your client credentials. Requires the user-follow-modify scope.

Responses

🟢200On 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](https://developer.spotify.com/documentation/web-api/reference/#obj

application/json

Body

artists

object

optional

cursors

object (CursorObject)

optional

href

string

optional

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

items

array[object (ArtistObject) {10}]

optional

The requested data.

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)

total

integer <int32>

optional

The total number of items available to return.

🔴500500

Modified at 2022-09-12 10:04:50

Unfollow Artists or Users

Follow Artists or Users