myanimelist-api v1.0.1

MyAnimeList API

This is a wrapper for the official MyAnimeList REST API V2. All the endpoints as defined in the documentation are supported including OAuth 2.0 authorization.

Installation

npm install myanimelist-api

Getting started

Generate API credentials by following these instructions.

Make sure to check the resource access is as per your requirements to prevent misuse of the API Keys.

Setup

Initializing the client

const MyAnimeList = require('myanimelist-api');

const mal = new MyAnimeList({
    'clientId': '<Your MAL Client ID>',
    'clientSecret': '<Your MAL Client Secret>',
});

Options

Requests are made with Axios library with support to promises. Error Handling is same as how Axios handles it.

Gerenate the Access Token and Refresh Token from Client

Since MAL V2 API uses oAuth 2 for authorization, you need to access MAL Web Page to allow your user to interact with your app.

const { challengeCode, url } = mal.auth.getChallenge();

In the above snippet, challengeCode is a PKCE compliant 128 character key which is generated in the getChallenge() function.

The user needs to be redirected to the url returned in the above snippet where they need to login with their MAL ID and allow access to your app.

After that, you will receive a code in the redirect URL from MAL. Now, using that code and the challengeCode, you need to do the following:

const { data } = await mal.auth.getRefreshToken(code, challengeCode);

The data has the access token as well as the refresh token.

Refresh your access token

const { data } = await mal.auth.refreshAccessToken(refreshToken);

To reissue the refresh token, you need to re-authorize your user on MAL, Follow from step 1.

API

To use the following methods, it is assumed that you have your access token as well as the refresh token, so you need to initialize the package a little differently.

const MyAnimeList = require('myanimelist-api');

const mal = new MyAnimeList({
    accessToken: "<Your access token>", 
    refreshToken: "<Your refresh token>",    
});

Anime

Details of a specific anime

const { data } = await mal.anime.details(11757, options);

Search

const { data } = await mal.anime.list("Your Name", options);

Seasonal Anime

const { data } = await mal.anime.seasonal("summer", 2012, options);

Ranking

const { data } = await mal.anime.ranking("all", options);

Suggested Anime

const { data } = await mal.anime.suggestions(options);

Manga

Details of a specific Manga

const { data } = await mal.manga.details(21479, options);

Search

const { data } = await mal.manga.list("Your Name", options);

Ranking

const { data } = await mal.manga.ranking("all", options);

Forum

Get Boards

const { data } = await mal.forum.boards(options);

Get Topics

const { data } = await mal.forum.topics(options);

Get Topic Details

const { data } = await mal.forum.details(17876, options);

User

Details

const { data } = await mal.user.details(username, options);

Get Anime List

const { data } = await mal.user.listAnime(username, options);

Update Anime List Entry

const { data } = await mal.user.updateAnime(11757, body);

Delete Anime List Entry

const { data } = await mal.user.deleteAnime(11757);

Get Manga List

const { data } = await mal.user.listManga(username, options);

Update Manga List Entry

const { data } = await mal.user.updateManga(11757, body);

Delete Manga List Entry

const { data } = await mal.user.deleteManga(11757);