This is documentation for version 20150623 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 /20150623/release POST /20150623/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:
/20150623/release?user_key=myUserKey&inc=images&title=Thriller&artist=Michael%20Jackson
Retrieves the images for Thriller by Michael Jackson.
/20150623/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.
inc=trackMatch
is also used.inc=trackMatch
is also used.
Use the Acoustid 'fp_calc' tool to generate fingerprints.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.
/20150623/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.
A Discogs release ID can be used to query OneMusicAPI, which will return aggregated information for that release from Discogs and all other aggregated databases to broaden the quantity of data retrievable.
Queries for releases given its barcode.
In addition, all queries can be further constrained with the following parameters:
inc
is set then the following additional items may be retrieved:
track.[m.]n
parameter that matched each track on a release.inc
, if this parameter is set then the following additional items may be retrieved:
/20150623/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.
/20150623/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.onemusicapi.com/20140925/images/discogs/2719042/1297955038", "width": "600", "height": "600" } ], "score": 1 } ]comments powered by Disqus