Skip to content
Spotted Docs Spotted Docs
DocumentationAPI Reference
API Reference
Artists

Get Artist

artists.retrieve(strid) -> ArtistObject
GET/artists/{id}

Get Spotify catalog information for a single artist identified by their unique Spotify ID.

ParametersExpand Collapse
id: str

The Spotify ID of the artist.

ReturnsExpand Collapse
class ArtistObject: …
id: Optional[str]

The Spotify ID for the artist.

external_urls: Optional[ExternalURLObject]

Known external URLs for this artist.

published: Optional[bool]

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: Optional[str]

The Spotify URL for the object.

followers: Optional[FollowersObject]

Information about the followers of the artist.

href: Optional[str]

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

published: Optional[bool]

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

total: Optional[int]

The total number of followers.

genres: Optional[List[str]]

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

href: Optional[str]

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

images: Optional[List[ImageObject]]

Images of the artist in various sizes, widest first.

height: Optional[int]

The image height in pixels.

url: str

The source URL of the image.

width: Optional[int]

The image width in pixels.

published: Optional[bool]

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

name: Optional[str]

The name of the artist.

popularity: Optional[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.

published: Optional[bool]

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

type: Optional[Literal["artist"]]

The object type.

uri: Optional[str]

The Spotify URI for the artist.

Get Artist 

import os
from spotted import Spotted

client = Spotted(
    access_token=os.environ.get("SPOTIFY_ACCESS_TOKEN"),  # This is the default and can be omitted
)
artist_object = client.artists.retrieve(
    "0TnOYISbd1XYRBk9myaseg",
)
print(artist_object.id)
{
  "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
{
  "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"
}