Get Spotify catalog information for several artists based on their Spotify IDs.
Endpoint
GET https://api.spotify.com/v1/artists?ids={ids}
Request Parameters
| Query argument | Value |
|---|---|
| ids | Required. A comma-separated list of the Spotify IDs for the artists. Maximum: 50 IDs. |
Response Format
On success, the HTTP status code in the response header is 200 OK and the response body contains an object whose key is "artists" and whose value is an array of artist objects in JSON format.
Objects are returned in the order requested. If an object is not found, a null value is returned in the appropriate position. Duplicate ids in the query will result in duplicate objects in the response. 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/?ids=0oSGxfWSnnOXhD2fKuz2Gy,3dBVyJ7JuOMt4GE9607Qin"
{
"artists" : [ {
"external_urls" : {
"spotify" : "https://open.spotify.com/artist/0oSGxfWSnnOXhD2fKuz2Gy"
},
"followers" : {
"href" : null,
"total" : 633494
},
"genres" : [ "art rock", "glam rock", "permanent wave" ],
"href" : "https://api.spotify.com/v1/artists/0oSGxfWSnnOXhD2fKuz2Gy",
"id" : "0oSGxfWSnnOXhD2fKuz2Gy",
"images" : [ {
"height" : 1000,
"url" : "https://i.scdn.co/image/32bd9707b42a2c081482ec9cd3ffa8879f659f95",
"width" : 1000
}, {
"height" : 640,
"url" : "https://i.scdn.co/image/865f24753e5e4f40a383bf24a9cdda598a4559a8",
"width" : 640
}, {
"height" : 200,
"url" : "https://i.scdn.co/image/7ddd6fa5cf78aee2f2e8b347616151393022b7d9",
"width" : 200
}, {
"height" : 64,
"url" : "https://i.scdn.co/image/c8dc28c191432862afce298216458a6f00bbfbd8",
"width" : 64
} ],
"name" : "David Bowie",
"popularity" : 77,
"type" : "artist",
"uri" : "spotify:artist:0oSGxfWSnnOXhD2fKuz2Gy"
}, {
"external_urls" : {
"spotify" : "https://open.spotify.com/artist/3dBVyJ7JuOMt4GE9607Qin"
},
"followers" : {
"href" : null,
"total" : 52338
},
"genres" : [ "glam rock", "protopunk" ],
"href" : "https://api.spotify.com/v1/artists/3dBVyJ7JuOMt4GE9607Qin",
"id" : "3dBVyJ7JuOMt4GE9607Qin",
"images" : [ {
"height" : 1300,
"url" : "https://i.scdn.co/image/5515a710c94ccd4edd8b9a0587778ed5e3f997da",
"width" : 1000
}, {
"height" : 832,
"url" : "https://i.scdn.co/image/c990e667b4ca8240c73b0db06e6d76a3b27ce929",
"width" : 640
}, {
"height" : 260,
"url" : "https://i.scdn.co/image/de2fa1d11c59e63143117d44ec9990b9e40451a2",
"width" : 200
}, {
"height" : 83,
"url" : "https://i.scdn.co/image/b39638735adb4a4a54621293b99ab65c546f605e",
"width" : 64
} ],
"name" : "T. Rex",
"popularity" : 58,
"type" : "artist",
"uri" : "spotify:artist:3dBVyJ7JuOMt4GE9607Qin"
} ]
}artist object
| 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. |