MyAnimeList-Module (NPM)

MyAnimeList Module

This module is neither affiliated with nor endorsed by MyAnimeList.
All data returned by this module is provided by MyAnimeList.

Version 1.0.5

Installation

Install myanimelist-module with npm

  npm install myanimelist-module

Usage/Examples

const { MyAnimeList } = require('myanimelist-module')
const mal = new MyAnimeList({
    client_id: `YOUR_MAL_CLIENT_ID` // Get it here: https://myanimelist.net/apiconfig
})

async function test() {
    const response = await mal.getAnimeInfo({
        name: "Anime name"
    })
    if(response.error) {
        console.error(response.error)
    } else {
        console.log(response.datas)
    }
}

test()

All functions

new MyAnimeList()

Parameter	Type	Description
client_id	string	Required. Your MAL Client ID

getAnimeInfo()

Parameter	Type	Description
name	string	Required.
fields	[array]	Optional. More information in the "Available fields" section.
limit	number	Optional. Number of items in the response. (Maximum of 100)
offset	number	Optional. Default : 0
nsfw	boolean	Optional. Default: false

getAnimeInfoByURL()

Parameter	Type	Description
api_url	string	Required. You must use any valid MyAnimeList API link. It also works with older responses via response.datas.paging.next and response.datas.paging.previous.

getSpecificAnimeInfo()

Parameter	Type	Description
name	string	Required.
fields	[array]	Optional. More information in the "Available fields" section.
nsfw	boolean	Optional. Default: false

getAnimeInfoByID()

Parameter	Type	Description
id	string	Required.
fields	[array]	Optional. More information in the "Available fields" section.
nsfw	boolean	Optional. Default: false

getAnimeRanking()

Parameter	Type	Description
type	string	Optional. More information in the "Available ranking types" section.
fields	[array]	Optional. More information in the "Available fields" section.
limit	number	Optional. Number of items in the response. (Maximum of 500)
offset	number	Optional. Default : 0
nsfw	boolean	Optional. Default: false

getSeasonalAnime()

Parameter	Type	Description
year	string	Optional. Default: current year
season	string	Optional. Default: current season (winter/spring/summer/fall)
fields	[array]	Optional. More information in the "Available fields" section.
limit	number	Optional. Number of items in the response. (Maximum of 100)
offset	number	Optional. Default : 0
nsfw	boolean	Optional. Default: false

getMangaInfo()

Parameter	Type	Description
name	string	Required.
fields	[array]	Optional. More information in the "Available fields" section.
limit	number	Optional. Number of items in the response. (Maximum of 100)
offset	number	Optional. Default : 0
nsfw	boolean	Optional. Default: false

getMangaInfoByURL()

Parameter	Type	Description
api_url	string	Required. You must use any valid MyAnimeList API link. It also works with older responses via response.datas.paging.next and response.datas.paging.previous.

getSpecificMangaInfo()

Parameter	Type	Description
name	string	Required.
fields	[array]	Optional. More information in the "Available fields" section.
nsfw	boolean	Optional. Default: false

getMangaInfoByID()

Parameter	Type	Description
id	string	Required.
fields	[array]	Optional. More information in the "Available fields" section.
nsfw	boolean	Optional. Default: false

getMangaRanking()

Parameter	Type	Description
type	string	Optional. More information in the "Available ranking types" section.
fields	[array]	Optional. More information in the "Available fields" section.
limit	number	Optional. Number of items in the response. (Maximum of 500)
offset	number	Optional. Default : 0
nsfw	boolean	Optional. Default: false

Available fields

Global

alternative_titles: object or null

start_date: string or null

end_date: string or null

synopsis: string or null

mean: number or null

rank: integer or null

popularity: integer or null

num_list_users: integer

num_scoring_users: integer

nsfw: string or null

Value	Description
white	This work is safe for work
gray	This work may be not safe for work
black	This work is not safe for work

Genres: Array of objects

created_at : string

updated_at: string

Anime only

media_type: string

• unknown
• tv
• ova
• movie
• special
• ona
• music

status: string

• finished_airing
• currently_airing
• not_yet_aired

num_episodes: integer

start_season: object or null

broadcast: object of null

source: string or null

• other
• original
• manga
• 4_koma_manga
• web_manga
• digital_manga
• novel
• light_novel
• visual_novel
• game
• card_game
• book
• picture_book
• radio
• music

average_episode_duration: integer or null

rating: string or null

Value	Description
g	All ages
pg	Children
pg_13	Teens 13 and Older
r	17+ (violence & profanity)
r+	Profanity & Mild Nudity
rx	Hentai

studios: Array of objects

Manga only

media_type: string

• unknown
• manga
• novel
• one_shot
• doujinshi
• manhwa
• manhua
• oel

status: string

• finished
• currently_publishing
• not_yet_published

num_volumes: integer

num_chapters: integer

authors: Array of objects

Available ranking types

Global

all

bypopularity

favorite

Anime only

airing

upcoming

tv

ova

movie

special

Manga only

manga

novels

oneshots

doujin

manhwa

manhua

Additional information

My Discord: https://discord.gg/2x9juZp9VX

NPM Module: https://www.npmjs.com/package/myanimelist-module