A project to be use as a wrapper for the Musicbrainz API. This is recommended to be used with another API that leverages Musicbrainz ID such as the Last.fm API. Musicbrainz is a metadata service that is opensource and independent of restrictive music databases such as the Compact Disc Database.
The MusicBrainz API will only return data if a valid MusicBrainz ID value has been inputted. This API does not leverage search queries.
The purpose of this project is to provide an interface between APIs that leverage MusicBrainz IDs such as LastFM and obtain that metadata.
DISCLAIMER: THIS IS NOT AFFLIATED WITH MUSICBRAINZ OR LASTFM
- Run: git clone "https://github.com/chinjon/mbrainz.git"
- CD into
mbrainz - Run:
npm install
- Run
npm run testin project root.
NOTE, MusicBrainz does not accept search queries. The valid MusicBrainz ID number must be known, which can be obtained via an API such as LastFM.
Searching for artist data
const mbrainz = require('mbrainz');
const NIRVANA_MBZ_ID = '5b11f4ce-a62d-471e-81fc-a69a8278c7da';
await mbrainz.getDataArtist(NIRVANA_MBZ_ID)
.then((artistData) => {
console.log(artistData);
});
// RETURNS
/**
{
"id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
"name": "Nirvana",
"sort-name": "Nirvana"
"type": "Group",
"country": "US",
"disambiguation": "90s US grunge band",
"life-span": {
"ended": true,
"begin": "1988-02",
"end": "1994-04-05"
},
"aliases": [ { "name": "Nirvana US", "sort-name": "Nirvana US" } ]]
}
* mbrainz.getDataArtist()- obtain data on artistmbrainz.getDataLabel()- obtain data on record labelmbrainz.getDataRecording()- obtain data on song/recording
Isomorphic Fetch- used to make API calls toMusicBrainzasync/await- used for asynchromous calls toMusicBrainzAPI
- MusicBrainz API - Node MusicBrainz API client for reading and submitting metadata