Get Several Artists

client.artists.bulkRetrieve(, ?): ArtistBulkRetrieveResponse { artists }

GET/artists

Get Spotify catalog information for several artists based on their Spotify IDs.

ParametersExpand Collapse

query: ArtistBulkRetrieveParams { ids }

ids: string

A comma-separated list of the Spotify IDs for the artists. Maximum: 50 IDs.

ReturnsExpand Collapse

ArtistBulkRetrieveResponse { artists }

artists: Array<ArtistObject { id, external_urls, followers, 8 more } >

id?: string

The Spotify ID for the artist.

external_urls?: ExternalURLObject { published, spotify }

Known external URLs for this artist.

published?: boolean

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

spotify?: string

The Spotify URL for the object.

followers?: FollowersObject { href, published, total }

Information about the followers of the artist.

href?: string | null

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

published?: boolean

total?: number

The total number of followers.

genres?: Array<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.

images?: Array<ImageObject { height, url, width, published } >

Images of the artist in various sizes, widest first.

height: number | null

The image height in pixels.

url: string

The source URL of the image.

width: number | null

The image width in pixels.

published?: boolean

name?: string

The name of the artist.

popularity?: number

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?: boolean

type?: "artist"

The object type.

uri?: string

The Spotify URI for the artist.

Get Several Artists

import Spotted from 'spotted-ts';

const client = new Spotted({
  accessToken: process.env['SPOTIFY_ACCESS_TOKEN'], // This is the default and can be omitted
});

const response = await client.artists.bulkRetrieve({
  ids: '2CIMQHirSU0MQqyYHq0eOx,57dN52uHvrHOxijzpIgu3E,1vCWHaC5f2uS3yhpwWbIA6',
});

console.log(response.artists);

{
  "artists": [
    {
      "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"
    }
  ]
}

Returns Examples

{
  "artists": [
    {
      "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"
    }
  ]
}