A "track" is a recording of a musical work. A given musical work may have been recorded multiple times, including in live events, cover versions and so on.
Tracks can sometimes be portions of a longer, uninterrupted work. This is quite common within classical pieces, where tracks may delineate the boundaries between different movements.
GET /20220401/track POST /20220401/track
The track
endpoint allows clients to retrieve metadata about given musical tracks,
given search parameters. The parameters are used to query OneMusicAPI's aggregated database of MusicBrainz,
Discogs and Wikipedia data.
Queries can be sent as a GET or POST request.
All queries must contain the following:
Title queries allow tracks to be queried according to the track title and artist name.
Also, one of artist
or artistId
must be provided (see Optional parameters).
/20220401/track?user_key=myUserKey&title=Pantomime+Horse&artist=Suede
Retrieves information about Pantomime Horse by Suede.
OneMusicAPI accepts queries for tracks using Acoustid fingerprints.
/20220401/track?user_key=myUserKey&track.1.duration=255&track.1.fingerprint=AQABz00mRVOLmkqD[...]
Retrieves information about the track with the specified fingerprint.
In addition, all queries can be further constrained with the following parameters:
inc
is set then the following additional items may be retrieved:
Here's an example response:
http://api.onemusicapi.com/20220401/track?title=Wildfire&artist=SBTRKT
[ { "title": "Wildfire", "artists": [ "SBTRKT" ], "releases": [ { "title": "SBTRKT", "artist": "SBTRKT", "year": "2011", "genre": "bass", "media": [ ], "images": [ { "url": "http://api.onemusicapi.com/20220401/images/caa/63b4acff-866a-4b80-90fa-9f4a2af3445d/4110790212.jpg", "width": "800", "height": "800" }, { "url": "http://api.onemusicapi.com/20220401/images/asin/B004Y6CS8I.jpg", "width": "360", "height": "360" } ], "uris": [ "http://musicbrainz.org/release/63b4acff-866a-4b80-90fa-9f4a2af3445d" ], "score": 1 }, { "title": "SBTRKT", "artist": "SBTRKT", "year": "2011", "genre": "bass", "media": [ ], "images": [ { "url": "http://api.onemusicapi.com/20220401/images/caa/2ffe2124-a770-442a-9a98-f450416cec92/2596669746.jpg", "width": "800", "height": "800" } ], "uris": [ "http://musicbrainz.org/release/2ffe2124-a770-442a-9a98-f450416cec92" ], "score": 1 } ], "uris": [ "http://musicbrainz.org/recording/1a325657-73bd-4ab9-8660-3bf302e84d42" ] } ]comments powered by Disqus