GraphQL Metal Archives

The Encyclopaedia Metallum: The Metal Archives is a colaborative website, focused in metal genre, that provides information about bands, albums, songs, artists and more. But unfortunately it does not have an official API to access their data. So this repository exists to provide a way to recover these infos with a GraphQL API.

Demo

* The Demo can take 3 to 5 minutes to load.

Live Demo

Install

1. Clone this repository

git clone https://github.com/caiopiassali/graphql-metalarchives.git

2. Navigate to project folder

cd graphql-metalarchives

3. Install dependencies

npm install

Run

Production

npm start

Development

npm run dev

After running the application the GraphQL Playground will be available at http://localhost:4000/graphql

Queries

Bands List

query {
  bands {
    id,
    name,
    genre,
    country
  }
}

Get Band

query {
  band(id: "9524") {
    name,
    genre,
    country,
    location,
    themes,
    status,
    label,
    formYear,
    yearsActive,
    photoUrl,
    logoUrl
  }
}

Get Band Discography

query {
  band(id: "9524") {
    discography {
      id,
      name,
      type,
      year
    }
  }
}

Get Band Discography Filtered By Type

query {
  band(id: "9524") {
    discography(type: "misc") {
      id,
      name,
      type,
      year
    }
  }
}

Get Album

query {
  album(id: "239675") {
    name,
    band,
    type,
    releaseDate,
    label,
    format,
    coverUrl
  }
}

Get Album Songs

query {
  album(id: "239675") {
    songs
  }
}

Get Lyrics

query {
  lyrics(id: "2699228") {
    lyrics
  }
}

Technologies

• Node.js
• Typescript
• NestJS
• GraphQL
• TypeGraphQL

Changelog

Read CHANGELOG.md for release details and changes.

License

This project is licensed under the MIT License - see the LICENSE file for details