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

Development

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

Testing

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

chinjon/mbrainz