Skip to content
We are updating the criteria to be granted extended access to the Web API.
Please note that starting May 15, 2025 we’re introducing some changes to the way we provide Web API extended quota mode access. For more information, read here.
Web API •References / Users / Get Followed Artists

Get Followed Artists

Get the current user's followed artists.

Authorization scopes

Request

  • type
    string
    Required

    The ID type: currently only artist is supported.

    Allowed values: "artist"Example: type=artist
  • after
    string

    The last artist ID retrieved from the previous request.

    Example: after=0I2XqVXqHScXjHhk6AYYRe
  • limit
    integer

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

    Default: limit=20Range: 0 - 50Example: limit=10

Response

A paged set of artists

  • Required
    • href
      string

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

    • 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)

    • The cursors used to find the next set of items.

      • after
        string

        The cursor to use as key to find the next page of items.

      • before
        string

        The cursor to use as key to find the previous page of items.

    • total
      integer

      The total number of items available to return.

      • Known external URLs for this artist.

      • Information about the followers of the artist.

        • 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
        array of strings

        A list of the genres the artist is associated with. If not yet classified, the array is empty.

        Example: ["Prog rock","Grunge"]
      • href
        string

        A link to the Web API endpoint providing full details of the artist.

      • id
        string

        The Spotify ID for the artist.

      • Images of the artist in various sizes, widest first.

        • url
          string
          Required

          The source URL of the image.

          Example: "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
        • height
          integer
          Required
          Nullable

          The image height in pixels.

          Example: 300
        • width
          integer
          Required
          Nullable

          The image width in pixels.

          Example: 300
      • 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
        string

        The object type.

        Allowed values: "artist"
      • uri
        string

        The Spotify URI for the artist.

Response sample

{  "artists": {    "href": "string",    "limit": 0,    "next": "string",    "cursors": {      "after": "string",      "before": "string"    },    "total": 0,    "items": [      {        "external_urls": {          "spotify": "string"        },        "followers": {          "href": "string",          "total": 0        },        "genres": ["Prog rock", "Grunge"],        "href": "string",        "id": "string",        "images": [          {            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228",            "height": 300,            "width": 300          }        ],        "name": "string",        "popularity": 0,        "type": "artist",        "uri": "string"      }    ]  }}