RESTful API
/api/v2/artist
Request Type
GET
Returns details about the recording artist or band.
Example URL
https://example.stitchz.net/api/v2/artist/000000?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408Rq4958qw3
Supported Providers
Request
| Required | Parameter | Type | Description |
|---|---|---|---|
|
Bearer | string | The application's unique Oauth2 bearer token (access token) in the request header |
|
Identity | string | The identity string provided by Stitchz when the user logged in. |
|
artistId | number | The id of the artist as given by the provider. Include the value in the URL of the request, e.g. /api/v2/artist/000000/releases |
| Format | string | The format of the authenticated Stitchz response, XML, JSON, JSONP. A query string parameter can be included in the request (e.g. ?format=json) or a header variable of "Accept" with the proper value, e.g. 'application/json', 'application/xml', etc. The default response is in "JSON" format. |
Example Request
$ curl -H "Authorization: Bearer e72e16c7e42f292c6912e7710c838347ae178b4a"
-H "Accept: application/json"
-A "example client"
https://example.stitchz.net/api/v2/artist/1234567890?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408Rq4958qw3
GET /api/v2/artist/1234567890?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408Rq4958qw3 HTTP/1.1
User-Agent: example client
Host: example.stitchz.net
Accept: application/json
Authorization: Bearer e72e16c7e42f292c6912e7710c838347ae178b4a
-H "Accept: application/json"
-A "example client"
https://example.stitchz.net/api/v2/artist/1234567890?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408Rq4958qw3
GET /api/v2/artist/1234567890?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408Rq4958qw3 HTTP/1.1
User-Agent: example client
Host: example.stitchz.net
Accept: application/json
Authorization: Bearer e72e16c7e42f292c6912e7710c838347ae178b4a
Response
The response returned contains the fields and attributes as defined by the service provider, i.e. Discogs, etc.
<artist>
<profile>Formed in July, 1965 in Los Angeles, CA, United States; disbanded in 1973. Inducted into Rock And Roll Hall of Fame in 1993 (Performer). </profile>
<urls>http://www.thedoors.com/</urls>
<urls>https://www.facebook.com/thedoors</urls>
<urls>http://thedoors.tumblr.com/</urls>
<urls>https://myspace.com/thedoors</urls>
<releases_url>http://api.discogs.com/artists/56798/releases</releases_url>
<name>Doors, The</name>
<uri>http://www.discogs.com/artist/56798-Doors-The</uri>
<realname>Jim Morrison, Ray Manzarek, Robby Krieger, John Densmore</realname>
<members>
<active>false</active>
<resource_url>http://api.discogs.com/artists/252840</resource_url>
<id>252840</id>
<name>Doug Lubahn</name>
</members>
<members>
<active>false</active>
<resource_url>http://api.discogs.com/artists/260501</resource_url>
<id>260501</id>
<name>Jim Morrison</name>
</members>
<members>
<active>true</active>
<resource_url>http://api.discogs.com/artists/271572</resource_url>
<id>271572</id>
<name>John Densmore</name>
</members>
<members>
<active>true</active>
<resource_url>http://api.discogs.com/artists/242088</resource_url>
<id>242088</id>
<name>Ray Manzarek</name>
</members>
<members>
<active>true</active>
<resource_url>http://api.discogs.com/artists/271569</resource_url>
<id>271569</id>
<name>Robby Krieger</name>
</members>
<images>
<uri>http://api.discogs.com/image/A-56798-1169678918.jpeg</uri>
<height>343</height>
<width>468</width>
<resource_url>http://api.discogs.com/image/A-56798-1169678918.jpeg</resource_url>
<type>primary</type>
<uri150>http://api.discogs.com/image/A-150-56798-1169678918.jpeg</uri150>
</images>
<images>
<uri>http://api.discogs.com/image/A-56798-1224871307.jpeg</uri>
<height>308</height>
<width>600</width>
<resource_url>http://api.discogs.com/image/A-56798-1224871307.jpeg</resource_url>
<type>secondary</type>
<uri150>http://api.discogs.com/image/A-150-56798-1224871307.jpeg</uri150>
</images>
<images>
<uri>http://api.discogs.com/image/A-56798-1288976713.jpeg</uri>
<height>435</height>
<width>600</width>
<resource_url>http://api.discogs.com/image/A-56798-1288976713.jpeg</resource_url>
<type>secondary</type>
<uri150>http://api.discogs.com/image/A-150-56798-1288976713.jpeg</uri150>
</images>
<images>
<uri>http://api.discogs.com/image/A-56798-1083849323.jpg</uri>
<height>200</height>
<width>200</width>
<resource_url>http://api.discogs.com/image/A-56798-1083849323.jpg</resource_url>
<type>secondary</type>
<uri150>http://api.discogs.com/image/A-150-56798-1083849323.jpg</uri150>
</images>
<images>
<uri>http://api.discogs.com/image/A-56798-1107985362.jpg</uri>
<height>204</height>
<width>200</width>
<resource_url>http://api.discogs.com/image/A-56798-1107985362.jpg</resource_url>
<type>secondary</type>
<uri150>http://api.discogs.com/image/A-150-56798-1107985362.jpg</uri150>
</images>
<resource_url>http://api.discogs.com/artists/56798</resource_url>
<id>56798</id>
<data_quality>Correct</data_quality>
<namevariations>(Early) Doors, The</namevariations>
<namevariations>ザ・ドアーズ</namevariations>
<namevariations>Door, The</namevariations>
<namevariations>Doors</namevariations>
<namevariations>Doors, The</namevariations>
<namevariations>Early Doors, The</namevariations>
<namevariations>Members Of The Doors</namevariations>
<namevariations>The Doors</namevariations>
</artist>
{
"profile":"Formed in July, 1965 in Los Angeles, CA, United States; disbanded in 1973.\r\n\r\nInducted into Rock And Roll Hall of Fame in 1993 (Performer).\r\n",
"releases_url":"http://api.discogs.com/artists/56798/releases",
"name":"Doors, The",
"namevariations":
[
"(Early) Doors, The",
"ザ・ドアーズ",
"Door, The",
"Doors",
"Doors, The",
"Early Doors, The",
"Members Of The Doors",
"The Doors"
],
"uri":"http://www.discogs.com/artist/56798-Doors-The",
"members":
[
{
"active":false,
"resource_url":"http://api.discogs.com/artists/252840",
"id":252840,
"name":"Doug Lubahn"
},
{
"active":false,
"resource_url":"http://api.discogs.com/artists/260501",
"id":260501,
"name":"Jim Morrison"
},
{
"active":true,
"resource_url":"http://api.discogs.com/artists/271572",
"id":271572,
"name":"John Densmore"
},
{
"active":true,
"resource_url":"http://api.discogs.com/artists/242088",
"id":242088,
"name":"Ray Manzarek"
},
{
"active":true,
"resource_url":"http://api.discogs.com/artists/271569",
"id":271569,
"name":"Robby Krieger"
}
],
"urls":
[
"http://www.thedoors.com/",
"https://www.facebook.com/thedoors",
"http://thedoors.tumblr.com/",
"https://myspace.com/thedoors"
],
"images":
[
{
"uri":"http://api.discogs.com/image/A-56798-1169678918.jpeg",
"height":343,
"width":468,
"resource_url":"http://api.discogs.com/image/A-56798-1169678918.jpeg",
"type":"primary",
"uri150":"http://api.discogs.com/image/A-150-56798-1169678918.jpeg"
},
{
"uri":"http://api.discogs.com/image/A-56798-1224871307.jpeg",
"height":308,
"width":600,
"resource_url":"http://api.discogs.com/image/A-56798-1224871307.jpeg",
"type":"secondary",
"uri150":"http://api.discogs.com/image/A-150-56798-1224871307.jpeg"
},
{
"uri":"http://api.discogs.com/image/A-56798-1288976713.jpeg",
"height":435,
"width":600,
"resource_url":"http://api.discogs.com/image/A-56798-1288976713.jpeg",
"type":"secondary",
"uri150":"http://api.discogs.com/image/A-150-56798-1288976713.jpeg"
},
{
"uri":"http://api.discogs.com/image/A-56798-1083849323.jpg",
"height":200,
"width":200,
"resource_url":"http://api.discogs.com/image/A-56798-1083849323.jpg",
"type":"secondary",
"uri150":"http://api.discogs.com/image/A-150-56798-1083849323.jpg"
},
{
"uri":"http://api.discogs.com/image/A-56798-1107985362.jpg",
"height":204,
"width":200,
"resource_url":"http://api.discogs.com/image/A-56798-1107985362.jpg",
"type":"secondary",
"uri150":"http://api.discogs.com/image/A-150-56798-1107985362.jpg"
}
],
"resource_url":"http://api.discogs.com/artists/56798",
"id":56798,
"data_quality":"Correct",
"realname":"Jim Morrison, Ray Manzarek, Robby Krieger, John Densmore"
}