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 |
---|---|---|---|
![]() |
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 |
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
-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.
<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"
}
}