This is documentation for version 20140520 which is deprecated. The current version is 20220401. We will continue to make deprecated versions available to customers who still use them, but new customers should use the latest version.
GET /20140520/release POST /20140520/release
Searches for releases. Queries to /release
must be either a name query, an
Acoustid fingerprint
query, a CD TOC query or a MusicBrainz Disc ID query.
Queries can be sent as a GET or POST request. In general, production use of OneMusicAPI should use POST for searches, because query URLs can otherwise get too long.
All queries must contain the following:
A name based query must include:
/20140520/release?user_key=myUserKey&inc=images&title=Thriller&artist=Michael%20Jackson
Retrieves the images for Thriller by Michael Jackson.
/20140520/release?user_key=myUserKey&inc=images&title=Smooth+Criminal&artist=Michael%20Jackson&inc=images&track.1.name%3DSmooth%0ACriminal%20(extended%20dance%20mix)%26track.2.name%3DSmooth%20Criminal%20(extended%20dance%20mix%20radio%20edit)%26track.3.name%3DSmooth%20Criminal%20%0A(%22Annie%22%20mix)%26track.4.name%3DSmooth%20Criminal%20(dance%20mix%20-%20dub%20version)%26track.5.name%3DSmooth%20Criminal%20(a%20cappella)%20
Retrieves the images for the Japanese version of the Smooth Criminal single by Michael Jackson.
OneMusicAPI accepts Acoustid fingerprints in queries.
These parameters help OneMusicAPI provide a more accurate score for each matched release. They can be useful because many releases (particularly classical releases) have identical or similar track listings.
/20140520/release?user_key=myUserKey&inc=images&track.1.duration=255&track.1.fingerprint=AQABz00mRVOLmkqD[...]
Retrieves the images for the release with the specified fingerprint. The fingerprint itself if too long to be replicated here. Such queries should always be sent as a POST.
CD Table Of Contents queries can be sent to OneMusicAPI.
MusicBrainz Disc ID queries can be sent to OneMusicAPI.
Queries for releases given its barcode.
In addition, all queries can be further constrained with the following parameters:
inc
is set to 'images
', then images are also returned./20140520/release?user_key=myUserKey&inc=images&title=Thriller&artist=Michael%20Jackson&minCertainty=0&maxResultCount=10
Retrieves up to 10 images for Thriller by Michael Jackson of low certainty.
/20140520/release?user_key=myUserKey&inc=images&title=Thriller&artist=Michael%20Jackson&minImageWidth=500&minImageHeight=500
Retrieves images for Thriller by Michael Jackson which is at least 500x500 pixels.
Here's an example response:
[ { "title": "habits", "artist": "Neon Trees", "media": [ { "tracks": [ { "title": "Sins Of My Youth", "number": "1" }, { "title": "Love And Affection", "number": "2" }, { "title": "Animal", "number": "3" }, { "title": "Your Surrender", "number": "4" }, { "title": "1983", "number": "5" }, { "title": "Girls And Boys In School", "number": "6" }, { "title": "In The Next Room", "number": "7" }, { "title": "Our War", "number": "8" } ] } ], "score": 1 }, { "title": "Habits", "artist": "Neon Trees", "year": "2011", "genre": "Rock", "media": [ { "tracks": [ { "title": "Sins Of My Youth", "number": "1", "artist": "" }, { "title": "Love And Affection", "number": "2", "artist": "" }, { "title": "Animal", "number": "3", "artist": "" }, { "title": "Your Surrender", "number": "4", "artist": "" }, { "title": "1983", "number": "5", "artist": "" }, { "title": "Girls And Boys In School", "number": "6", "artist": "" }, { "title": "In The Next Room", "number": "7", "artist": "" }, { "title": "Our War", "number": "8", "artist": "" } ] } ], "images": [ { "url": "http://api.discogs.com/image/R-2719042-1297955038.jpeg", "width": "600", "height": "600" } ], "score": 1 } ]comments powered by Disqus