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
yes Bearer string The application's unique Oauth2 bearer token (access token) in the request header
yes Identity string The identity string provided by Stitchz when the user logged in.
yes 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
Response
The response returned contains the fields and attributes as defined by the service provider, i.e. Discogs, etc.
 
Example XML Response
Example JSON Response
<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"
}