Get Followed Artists

client.Me.Following.BulkGet(ctx, query) (*MeFollowingBulkGetResponse, error)

GET/me/following

Get the current user's followed artists.

ParametersExpand Collapse

query MeFollowingBulkGetParams

Type param.Field[Artist]

The ID type: currently only artist is supported.

const ArtistArtist Artist = "artist"

After param.Field[string]optional

The last artist ID retrieved from the previous request.

Limit param.Field[int64]optional

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

minimum1

maximum50

ReturnsExpand Collapse

type MeFollowingBulkGetResponse struct{…}

Artists MeFollowingBulkGetResponseArtists

Cursors MeFollowingBulkGetResponseArtistsCursorsoptional

The cursors used to find the next set of items.

After stringoptional

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

Before stringoptional

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

Published booloptional

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Href stringoptional

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

Items []ArtistObjectoptional

ID stringoptional

The Spotify ID for the artist.

ExternalURLs ExternalURLObjectoptional

Known external URLs for this artist.

Published booloptional

Spotify stringoptional

The Spotify URL for the object.

Followers FollowersObjectoptional

Information about the followers of the artist.

Href stringoptional

This will always be set to null, as the Web API does not support it at the moment.

Published booloptional

Total int64optional

The total number of followers.

Genres []stringoptional

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

Href stringoptional

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

Images []ImageObjectoptional

Images of the artist in various sizes, widest first.

Height int64

The image height in pixels.

URL string

The source URL of the image.

Width int64

The image width in pixels.

Published booloptional

Name stringoptional

The name of the artist.

Popularity int64optional

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.

Published booloptional

Type ArtistObjectTypeoptional

The object type.

Uri stringoptional

The Spotify URI for the artist.

Limit int64optional

The maximum number of items in the response (as set in the query or by default).

Next stringoptional

URL to the next page of items. ( null if none)

Published booloptional

Total int64optional

The total number of items available to return.

Get Followed Artists

package main

import (
  "context"
  "fmt"

  "github.com/cjavdev/spotted-go"
  "github.com/cjavdev/spotted-go/option"
)

func main() {
  client := spotted.NewClient(
    option.WithAccessToken("My Access Token"),
  )
  response, err := client.Me.Following.BulkGet(context.TODO(), spotted.MeFollowingBulkGetParams{
    Type: "artist",
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Artists)
}

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

Returns Examples

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