RESTful API

 

/api/v2/artist/releases

Request Type
GET
 
Returns the recording artist's releases or details about a release if a releaseId is provided.
 
Example URL
https://example.stitchz.net/api/v2/artist/000000/releases/123456?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408qq4958qw3&Page=1
 
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
  releaseId number The id of the release as given by the provider. Include the value in the URL of the request, e.g. /api/v2/artist/000000/releases/123456
  page number The page number in the list of releases.
  perPage number The number of releases per page, by default 50 items per page are shown (max 100).
  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/releases/123456?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408Rq4958qw3

GET /api/v2/artist/1234567890/releases/123456?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
<release>
    <styles>Blues Rock</styles>
    <styles>Psychedelic Rock</styles>
    <styles>Classic Rock</styles>
    <videos>
        <duration>640</duration>
        <embed>true</embed>
        <title>The Doors - The End (1967)</title>
        <description>The Doors - The End (1967)</description>
        <uri>http://www.youtube.com/watch?v=ZDN9y2vTdUs</uri>
    </videos>
    <labels>
        <resource_url>http://api.discogs.com/labels/83625</resource_url>
        <entity_type> </entity_type>
        <catno>0 75596 25881 4</catno>
    <id>83625</id>
        <name>Ying Yang</name>
    </labels>
    <year>1971</year>
    <community>
        <status>Accepted</status>
        <rating>
            <count>5</count>
            <average>4.6</average>
        </rating>
        <want>11</want>
        <contributors>
            <username>Skvalradio</username>
            <resource_url>http://api.discogs.com/users/Skvalradio</resource_url>
        </contributors>
        <contributors>
            <username>Diognes_The_Fox</username>
            <resource_url>http://api.discogs.com/users/Diognes_The_Fox</resource_url>
        </contributors>
        <contributors>
            <username>encephalone</username>
            <resource_url>http://api.discogs.com/users/encephalone</resource_url>
        </contributors>
        <contributors>
            <username>losAntonis</username>
            <resource_url>http://api.discogs.com/users/losAntonis</resource_url>
        </contributors>
        <contributors>
            <username>brianvy</username>
            <resource_url>http://api.discogs.com/users/brianvy</resource_url>
        </contributors>
        <have>17</have>
        <submitter>
            <username>Skvalradio</username>
            <resource_url>http://api.discogs.com/users/Skvalradio</resource_url>
        </submitter>
        <data_quality>Correct</data_quality>
    </community>
    <artists>
        <join> </join>
        <name>Doors, The</name>
        <anv> </anv>
        <tracks>
        </tracks>
        <role> </role>
        <resource_url>http://api.discogs.com/artists/56798</resource_url>
        <id>56798</id>
    </artists>
    <images>
        <uri>http://api.discogs.com/image/R-1071886-1313155449.jpeg</uri>
        <height>281</height>
        <width>283</width>
        <resource_url>http://api.discogs.com/image/R-1071886-1313155449.jpeg</resource_url>
        <type>primary</type>
        <uri150>http://api.discogs.com/image/R-150-1071886-1313155449.jpeg</uri150>
    </images>
    <format_quantity>1</format_quantity>
    <id>1071886</id>
    <genres>Rock</genres>
    <thumb>http://api.discogs.com/image/R-150-1071886-1313155449.jpeg</thumb>
    <title>Open Up And Bleed</title>
    <master_id>528996</master_id>
    <tracklist>
        <duration>16:37</duration>
        <position>A1</position>
        <title>Rock Is Dead (Session 8/12/1970)</title>
    </tracklist>
    <tracklist>
        <duration>2:50</duration>
        <position>A2</position>
        <title>Crystal Ship (Toronto - Open Air Festival 1968)</title>
    </tracklist>
    <tracklist>
        <duration>1:52</duration>
        <position>A3</position>
        <title>Holy Sha Poem (Boston 17/3/1968)</title>
    </tracklist>
    <tracklist>
        <duration>5:12</duration>
        <position>B1</position>
        <title>Alabama Song / Backdoor Man (Danish T.V. 9/1968)</title>
    </tracklist>
    <tracklist>
        <duration>4:32</duration>
        <position>B2</position>
        <title>Build Me A Woman (P.B.S. Studios N.Y. 1969)</title>
    </tracklist>
    <tracklist>
        <duration>4:02</duration>
        <position>B3</position>
        <title>Get Off My Life (Live At The Matrix 1967)</title>
    </tracklist>
    <tracklist>
        <duration>6:52</duration>
        <position>B4</position>
        <title>Ship Of Fools (Isle Of Wight Festival 29/8/1970)</title>
    </tracklist>
    <status>Accepted</status>
    <released_formatted>1971</released_formatted>
    <estimated_weight>230</estimated_weight>
    <master_url>http://api.discogs.com/masters/528996</master_url>
    <released>1971</released>
    <notes>Live recordings. White marbled vinyl. </notes>
    <uri>http://www.discogs.com/Doors-Open-Up-And-Bleed/release/1071886</uri>
    <formats>
        <text>White</text>
        <qty>1</qty>
        <descriptions>LP</descriptions>
        <descriptions>Unofficial Release</descriptions>
        <name>Vinyl</name>
    </formats>
    <resource_url>http://api.discogs.com/releases/1071886</resource_url>
    <data_quality>Correct</data_quality>
</release>
{
    "release":
    {
    "styles": [
        "Blues Rock",
        "Psychedelic Rock",
        "Classic Rock"
    ],
    "videos": [
        {
            "duration": 640,
            "embed": true,
            "title": "The Doors - The End (1967)",
            "description": "The Doors - The End (1967)",
            "uri": "http://www.youtube.com/watch?v=ZDN9y2vTdUs"
        }
    ],
    "series": [],
    "labels": [
        {
            "resource_url": "http://api.discogs.com/labels/83625",
            "entity_type": "",
            "catno": "0 75596 25881 4",
            "id": 83625,
            "name": "Ying Yang"
        }
    ],
    "year": 1971,
    "community": {
        "status": "Accepted",
        "rating": {
            "count": 5,
            "average": 4.6
        },
        "want": 11,
        "contributors": [
            {
                "username": "Skvalradio",
                "resource_url": "http://api.discogs.com/users/Skvalradio"
            },
            {
                "username": "Diognes_The_Fox",
                "resource_url": "http://api.discogs.com/users/Diognes_The_Fox"
            },
            {
                "username": "encephalone",
                "resource_url": "http://api.discogs.com/users/encephalone"
            },
            {
                "username": "losAntonis",
                "resource_url": "http://api.discogs.com/users/losAntonis"
            },
            {
                "username": "brianvy",
                "resource_url": "http://api.discogs.com/users/brianvy"
            }
        ],
        "have": 17,
        "submitter": {
            "username": "Skvalradio",
            "resource_url": "http://api.discogs.com/users/Skvalradio"
        },
        "data_quality": "Correct"
    },
    "artists": [
        {
            "join": "",
            "name": "Doors, The",
            "anv": "",
            "tracks": "",
            "role": "",
            "resource_url": "http://api.discogs.com/artists/56798",
            "id": 56798
        }
    ],
    "images": [
        {
            "uri": "http://api.discogs.com/image/R-1071886-1313155449.jpeg",
            "height": 281,
            "width": 283,
            "resource_url": "http://api.discogs.com/image/R-1071886-1313155449.jpeg",
            "type": "primary",
            "uri150": "http://api.discogs.com/image/R-150-1071886-1313155449.jpeg"
        }
    ],
    "format_quantity": 1,
    "id": 1071886,
    "genres": [
        "Rock"
    ],
    "thumb": "http://api.discogs.com/image/R-150-1071886-1313155449.jpeg",
    "extraartists": [],
    "title": "Open Up And Bleed",
    "master_id": 528996,
    "tracklist": [
        {
            "duration": "16:37",
            "position": "A1",
            "title": "Rock Is Dead (Session 8/12/1970)"
        },
        {
        "duration": "2:50",
            "position": "A2",
            "title": "Crystal Ship (Toronto - Open Air Festival 1968)"
        },
        {
            "duration": "1:52",
        "position": "A3",
            "title": "Holy Sha Poem (Boston 17/3/1968)"
        },
        {
            "duration": "5:12",
            "position": "B1",
            "title": "Alabama Song / Backdoor Man (Danish T.V. 9/1968)"
        },
        {
            "duration": "4:32",
        "position": "B2",
            "title": "Build Me A Woman (P.B.S. Studios N.Y. 1969)"
        },
        {
            "duration": "4:02",
            "position": "B3",
            "title": "Get Off My Life (Live At The Matrix 1967)"
        },
        {
            "duration": "6:52",
            "position": "B4",
            "title": "Ship Of Fools (Isle Of Wight Festival 29/8/1970)"
        }
    ],
    "status": "Accepted",
    "released_formatted": "1971",
     "estimated_weight": 230,
    "master_url": "http://api.discogs.com/masters/528996",
    "released": "1971",
    "notes": "Live recordings.\r\nWhite marbled vinyl.\n",
    "companies": [],
    "uri": "http://www.discogs.com/Doors-Open-Up-And-Bleed/release/1071886",
    "formats": [
        {
            "text": "White",
            "qty": "1",
             "descriptions": [
                 "LP",
                 "Unofficial Release"
             ],
             "name": "Vinyl"
        }
    ],
    "resource_url": "http://api.discogs.com/releases/1071886",
    "data_quality": "Correct"
    }
}