This is documentation for version 20130130 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 /20130130/release POST /20130130/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:
images
is supported.A name based query must include:
/20130130/release?user_key=myUserKey&inc=images&title=Thriller&artist=Michael%20Jackson
Retrieves the images for Thriller by Michael Jackson.
/20130130/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.
/20130130/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.
In addition, all queries can be further constrained with the following parameters:
/20130130/release?user_key=myUserKey&inc=images&title=Thriller&artist=Michael%20Jackson&minCertainty=0&maxResultCount=20
Retrieves up to 20 images for Thriller by Michael Jackson of low certainty.
/20130130/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:
{ "releases" : [ { "title" : "Thriller", "artist" : "Michael Jackson", "year" : "1980", "genre" : "Pop", "images" : [ { "url" : "http://upload.wikimedia.org/wikipedia/en/5/51/Michaeljacksonthrilleralbum.jpg", "width" : "300", "height" : "298" } ], "score" : "1.0" } ] }comments powered by Disqus