Get Spotify catalog information for a single artist identified by their unique Spotify ID.
Endpoint
GET https://api.spotify.com/v1/artists/{id}
Request Parameters
| Path element | Value |
|---|---|
| id | The Spotify ID for the artist. |
Response Format
On success, the HTTP status code in the response header is 200 OK and the response body contains an artist object in JSON format. On error, the header status code is an error code and the response body contains an error object.
Example
curl -X GET "https://api.spotify.com/v1/artists/0OdUWJ0sBjDrqHygGUXeCF"
{
"external_urls" : {
"spotify" : "https://open.spotify.com/artist/0OdUWJ0sBjDrqHygGUXeCF"
},
"followers" : {
"href" : null,
"total" : 306565
},
"genres" : [ "indie folk", "indie pop" ],
"href" : "https://api.spotify.com/v1/artists/0OdUWJ0sBjDrqHygGUXeCF",
"id" : "0OdUWJ0sBjDrqHygGUXeCF",
"images" : [ {
"height" : 816,
"url" : "https://i.scdn.co/image/eb266625dab075341e8c4378a177a27370f91903",
"width" : 1000
}, {
"height" : 522,
"url" : "https://i.scdn.co/image/2f91c3cace3c5a6a48f3d0e2fd21364d4911b332",
"width" : 640
}, {
"height" : 163,
"url" : "https://i.scdn.co/image/2efc93d7ee88435116093274980f04ebceb7b527",
"width" : 200
}, {
"height" : 52,
"url" : "https://i.scdn.co/image/4f25297750dfa4051195c36809a9049f6b841a23",
"width" : 64
} ],
"name" : "Band of Horses",
"popularity" : 59,
"type" : "artist",
"uri" : "spotify:artist:0OdUWJ0sBjDrqHygGUXeCF"
}
artist object (full)
| Key | Value Type | Value Description |
|---|---|---|
| external_urls | an external URL object | Known external URLs for this artist. |
| followers | A followers object | Information about the followers of the artist. |
| genres | array of strings | A list of the genres the artist is associated with. For example: "Prog Rock", "Post-Grunge". (If not yet classified, the array is empty.) |
| href | string | A link to the Web API endpoint providing full details of the artist. |
| id | string | The Spotify ID for the artist. |
| images | array of image objects | Images of the artist in various sizes, widest first. |
| name | string | The name of the artist |
| popularity | 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. |
| type | string | The object type: "artist" |
| uri | string | The Spotify URI for the artist. |
Frequenty Asked Questions
- Is it possible to fetch a random artist?
Although there is no specific endpoint for this, you can retrieve an artist at random following this instructions.Within the query string, our search endpoint accepts the year tag for artist queries, for example:
q=year:2000&type=artistorq=year:0000-9999&type=artist. First call the endpoint with a suitable date or date range and read the total number of results returned. Then call the endpoint again setting limit=1 and offset to a random number smaller that the total that was returned. Here is an example:curl -X GET "https://api.spotify.com/v1/search?q=year%3A2001&type=artist&market=US"(returns 65934 results)
curl -X GET "https://api.spotify.com/v1/search?q=year%3A2001&type=artist&market=US&limit=1&offset=12345"
(returns the artist “Carolina Chamber Choir”)