mbrainz

Background

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

Links

• MusicBrainz Website
• MusicBrainz Wikipedia
• MusicBrainz API Documentation

---

Development

1. Run: git clone "https://github.com/chinjon/mbrainz.git"
2. CD into mbrainz
3. Run: npm install

---

Testing

1. Run npm run test in project root.

---

Usage

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" } ]]
  }
 *  

---

Available search paramters

• mbrainz.getDataArtist() - obtain data on artist
• mbrainz.getDataLabel() - obtain data on record label
• mbrainz.getDataRecording() - obtain data on song/recording

---

Stuff Under The Hood

• Isomorphic Fetch - used to make API calls to MusicBrainz
• async/await - used for asynchromous calls to MusicBrainz API

---

Similar Libraries

• MusicBrainz API - Node MusicBrainz API client for reading and submitting metadata