0.0.6 • Published 1 year ago

myanimelist.net v0.0.6

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

Table of contents

Installation

# with npm
$ npm install myanimelist.net

# or with Yarn
$ yarn add myanimelist.net

Documentation

new MyAnimeList(token)

  • token - token for authorization of requests (Required)

Anime

getAnime(search, resultLimit)

Search anime by name

  • search - string that will be queried in the api (Required)
  • resultLimit - amout of results (Default value: 4)

Returns:    Promise[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)

getAnimeById(id, fields)

Get anime by id

  • id - anime id (Required)
  • fields - an array that contains the returns fields (Optional)

Returns:    Promise[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)

getAnimeRanking(type, resultLimit)

Anime list by ranking

  • type - anime type (Required)
    • types: all | airing | upcoming | tv | ova | movie | special | bypopularity | favorite
  • resultLimit - amout of results (Default value: 4)

Returns:    Promise[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)

getAnimeBySuggestion(resultLimit)

Suggest anime

  • resultLimit - amout of results (Default value: 4)

Returns:    Promise[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)

getAnimeBySeason(year, season, resultLimit)

Get seasonal anime

  • year - anime year (Required)
  • season - seasonal (Required)
    • seasons: winter | spring | summer | fall
  • resultLimit - amout of results (Default value: 4)

Returns:    Promise[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)

Manga

getManga(search)

Search manga by name

  • search - string that will be queried in the api (Required)

Returns:    Promise[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)

getMangaById(id, fields)

Get manga by id

  • id - manga id (Required)
  • fields - an array that contains the returns fields (Optional)

Returns:    Promise[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)

getMangaRanking(type, resultLimit)

Manga list by ranking

  • type - manga type (Required)
    • types: all | manga | oneshots | doujin | lightnovels | novels | manhwa | manhua | bypopularity | favorite
  • resultLimit - amout of results (Default value: 4)

Returns:    Promise[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)

Example

const MyAnimeList = require('myanimelist.net')
const mal = new MyAnimeList('your-token')

mal.getMangaById(2)
  .then(console.log)
  .catch(console.error)

Returns

{
  "id": 2,
  "title": "Berserk",
  "main_picture": {
    "medium": "https:\/\/api-cdn.myanimelist.net\/images\/manga\/1\/157931.jpg",
    "large": "https:\/\/api-cdn.myanimelist.net\/images\/manga\/1\/157931l.jpg"
  }
}