MyAnimeList - API V2

An awesome library to connect with the new MyAnimeList's API v2!
Explore the docs »

Report Bug · Request Feature

Official documentation

This is the official documentation from MyAnimeList, if you need to verify any field. https://myanimelist.net/apiconfig/references/api/v2

About The Project

This library has been made by the new MyAnimeList API update, as it has some notable changes, the library will continue to be updated and changes will be made as the official API is developed

Built With

The library is made to be as light as possible.

NodeJS
Axios

Getting Started

TODO

API_OAUTH
- Access Token
- Refresh Token
- Generate url OAUTH2 for MyAnimeList
API_ANIME
- Return all fields by default
- Search Anime by Id
- Seach Anime by a query text
- Anime by season
- Anime ranking
- Anime suggestions
- Return anime with custom fields by parameter
API_MANGA
- Search Manga by Id
- Seach Manga by a query text
- Manga ranking
- Return all fields by default
- Return manga with custom fields by parameter
API_USER
- Return user's profile current session
- Return all fields by default
- Return user with custom fields by parameter
API_ANIME_LIST
- Get user's anime list
- Delete entry anime list
- Update entry anime list
API_MANGA_LIST
- Get user's manga list
- Delete entry manga list
- Update entry manga list
API_FORUM
- TODO

Prerequisites

You are going to need register your application first for the use of this API, so you can register here https://myanimelist.net/apiconfig/create You will get a result like this:
Client_id and Client_Secret (if you need it) must not be disclosed.
App Redirect Url: In this field we must put the url to which it will be redirected after the user authorizes the use of his account in our application (can be localhost for test purpose)

Install

Install the package to your project npm i @chris-kode/myanimelist-api-v2

Usage

This new API use PCKE for Oauth2 you can use this library to generate PCKE Challenge for the example i will use this library: pkce-challenge

Initial stepts before use the API

To redirect to the url for authorize

const API = require("@chris-kode/myanimelist-api-v2");

const oauth = new API.OAUTH(CLIENT_ID);
const pkceChallenge = require("pkce-challenge");

//save this variable value that contains the code_challenge and code_verification in a database or something
const pkce = pkceChallenge();

const urlToRedirect = oauth.urlAuthorize(pkce.code_challenge); // this generate the url that you need to redirect

//This example is for expressjs, but you only need to do a redirection to the url generated
res.redirect(urlToRedirect);

When the user authorize you, the user will be redirected again to the url that you filled at the information of the application, with a param "code", you are going to save this code in a database or something.

Then when we have this code, we will need to create a session or a Access Token like this:

const API = require("@chris-kode/myanimelist-api-v2");
const oauth = new API.OAUTH(CLIENT_ID);

//get the code that mal give us, and the code_challenge which we have generated before.
oauth.accessToken(CODE, CODE_CHALLENGE).then(
  ((response) => {
    //PERFECT
    //save all the response at db or something, u will get something like this:
    /*{
        token_type: 'Bearer',
        expires_in: 2678400,
        access_token: 'eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY4MWExNTIzYzBkZjI0MWNmNDlmZTg1Y2Y2MmQ5ZWU2ZDNjNDJlMGQ3ODIzN2I4ZjQ1NjkzMjUxZDdlYzhjZjIyYTVmNzdjZGY3MmJkMTkyIn0.e...,
        refresh_token: 'def502009f00fd0d08d50a7faca228bb4f88fa61df80e70aab290d6431115a16b44dc3e9215b3489a71caf9d594b8803129b6497619928025a420f107efd4560b45eb4e136bc4d0d72...'
    }*/
  }).catch((err) => {
    //ERROR
    //do something
  })
);

If the session is expired, you are going to need to refresh:

const API = require("@chris-kode/myanimelist-api-v2");
const oauth = new API.OAUTH(CLIENT_ID);

//REFRESH TOKEN that we generated before, when we create a Access Token
oauth.refreshToken(REFRESH_TOKEN).then(
  ((response) => {
    //PERFECT
    //save all the response at db or something, u will get something like this:
    /*{
        token_type: 'Bearer',
        expires_in: 2678400,
        access_token: 'eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY4MWExNTIzYzBkZjI0MWNmNDlmZTg1Y2Y2MmQ5ZWU2ZDNjNDJlMGQ3ODIzN2I4ZjQ1NjkzMjUxZDdlYzhjZjIyYTVmNzdjZGY3MmJkMTkyIn0.e...,
        refresh_token: 'def502009f00fd0d08d50a7faca228bb4f88fa61df80e70aab290d6431115a16b44dc3e9215b3489a71caf9d594b8803129b6497619928025a420f107efd4560b45eb4e136bc4d0d72...'
    }*/
  }).catch((err) => {
    //ERROR
    //do something
  })
);

OAUTH

Initialize object

//Client_Id as first parameter, and optional Cliente Secret if is need it.
const oauth = new API.OAUTH(CLIENT_ID, CLIENT_SECRET);

urlAuthorize

Function that return the url that we need to redirect for the user to authorize our application, we need a pcke code challenge, you can generate with this library: pkce-challenge

Params:

code_challenge => Generated code_challenge

//first parameter we need a code_challenge
res.redirect(oauth.urlAuthorize(pcke.code_challenge));

accessToken

Function that generates a Bearer and Refresh Token, we will need to generate a session and makes petition to the API

Params:

code => code that we get when our user has authorized us at the callback url
code_challenge => the code_generated before, the same code_challenge that we generated before.

oauth
  .accessToken(CODE, CODE_CHALLENGE)
  .then((response) => {
    //ALL OK
    //DO SOMETHING
  })
  .catch((err) => {
    //ALL BAD
    //DO SOMETHING
  });

refreshToken

Function that refresh the token that we got in "accessToken", if our token expired u can refresh with this function

Params:

REFRESH_TOKEN => token that we got, in the step "accesstoken".

oauth
  .refreshToken(REFRESH_TOKEN)
  .then((response) => {
    //ALL OK
    //DO SOMETHING
  })
  .catch((err) => {
    //ALL BAD
    //DO SOMETHING
  });

API_ANIME

Initialize object

//BEARER_TOKEN (ONLY THE TOKEN) = eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY4MWExNTIzYzBkZjI0MWNmNDlmZTg1Y2Y2MmQ5ZWU2ZDNjNDJlMGQ3ODIzN2I4ZjQ1NjkzMjUxZDdlYzhjZjIyYTVmNzdjZGY3MmJkMTkyIn0.ey...
const anime = new API.API_ANIME(BEARER_TOKEN);

Structures structures.animeInList

animes

(List of animes via a query text search)

Params:

q => text to search (required)
offset => default = 0
limit => default = 100

fields (Array) => fields to show, default = structures.animeInList

Example:

//Simple query
anime.animes("one piece");

//Third page of one piece results, 50 limit, 100-150,
anime.animes("one piece", 150, 50);

anime

(Specific anime by id, and return the anime with all details)

Params:

id => number
fields (Array) => fields to show, default = structures.animeFull

Example:
```
anime.anime(21);
```

animeRanking

(Ranking animes, with all type of rankings)

Params:

ranking_type => OPTIONS ["all" | "airing" | "upcoming" | "tv" | "ova" | "movie" | "special" | "bypopularity" | "favorite"] default = "all"
offset => default = 0
limit => default = 100

fields (Array) => fields to show, default = structures.animeInList

Example:

//Get all the ranking where is now airing
anime.animeRanking("airing");

//Third page of ranking results, 50 limit, 100-150,
anime.animeRanking("all", 150, 50);

animeSeasonal

(Seasonal Anime, by default is filled at actual season)

Params:

year => a year, default => currentYear
season => OPTIONS ["winter" | "spring" | "summer" | "fall"], default => currentSeason
offset => default = 0
limit => default = 100
sort => OPTIONS ["anime_score" | "anime_num_list_users" | ""], default => ""

fields (Array) => fields to show, default = structures.animeInList

Example:

//Get all the current anime season
anime.animeSeasonal();

//Get the animes season of winter 2010
anime.animeSeasonal(2010, "winter");

//Get the animes season of spring 2015, third page ordered by anime_score
anime.animeSeasonal(2015, "spring", 150, 50, "anime_score");

animeSuggestions

(Anime suggestion from MAL)

Params:

offset => default = 0
limit => default = 100
fields (Array) => fields to show, default = structures.animeInList

Example:
```
//Get the anime suggestion from MAL
anime.animeSuggestions();
```

API_MANGA

Initialize object

/*BEARER_TOKEN (ONLY THE TOKEN) = eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY4MWExNTIzYzBkZjI0MWNmNDlmZTg1Y2Y2MmQ5ZWU2ZDNjNDJlMGQ3ODIzN2I4ZjQ1NjkzMjUxZDdlYzhjZjIyYTVmNzdjZGY3MmJkMTkyIn0.ey...
 */
const manga = new API.API_MANGA(BEARER_TOKEN);

mangas

(List of mangas via a query text search)

Params:

q => text to search (required)
offset => default = 0
limit => default = 100

fields (Array) => default = structures.mangaInList

Example:

//Simple query
manga.mangas("one piece");

//Third page of one piece results, 50 limit, 100-150,
manga.mangas("one piece", 150, 50);

manga

(Specific manga by id, and return the manga with all details)

Params:

id => number
fields (Array) => default = structures.mangaFull

Example:
```
//Simple query
manga.manga(13);
```

mangaRanking

(Ranking mangas, with all type of rankings)

Params:

ranking_type => OPTIONS => ["all" | "manga" | "novels" | "oneshots" | "doujin" | "manhwa" | "manhua" | "bypopularity" | "favorite"], default => "all"
offset => default = 0
limit => default = 100

fields (Array) => default = structures.mangaInList

Example:

//Get all the ranking where are mangas
manga.mangaRanking("manga");

//Third page of ranking results, 50 limit, 100-150,
anime.mangaRanking("all", 150, 50);

API_ANIME_LIST

Initialize object

/*BEARER_TOKEN (ONLY THE TOKEN) = eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY4MWExNTIzYzBkZjI0MWNmNDlmZTg1Y2Y2MmQ5ZWU2ZDNjNDJlMGQ3ODIzN2I4ZjQ1NjkzMjUxZDdlYzhjZjIyYTVmNzdjZGY3MmJkMTkyIn0.ey...
 */
const anime_list = new API.API_LIST_ANIME(BEARER_TOKEN);

getListAnime

(Display user anime list with current session)

Params:

user_name (String) (username) => default = "@me"
offset (Number) => default = 0
limit (Number) => default = 100
fields (Array) => default = structures (This is a mix of anime structure and status structure)

//Third page of results, 50 limit, 100-150,
anime_list.getList("@me", 150, 50);

deleteListAnime

(Delete a anime entry from the list with current session)

Params:

anime_id (Number) => (anime_id that you want delete from the list)

//Delete Boku no hero academy 3º season from my anime list.
anime_list.deleteList(36456);

updateListAnime

(Update anime entry from the list with current session)

Params:

anime_id (Number) => (anime_id that you want update from the list)
fieldsToUdpate (Object)(All the fields are optional) => { status: "watching" | "completed" | "on_hold" | "dropped" | "plan_to_watch", is_rewatching: true | false, score: 0-10, num_watched_episodes: Number, priority: 0-2, num_times_rewatched: Number, rewatch_value: 0-5, tags: String, comments: String }

//Update Boku no hero 3 entry with status completed and score 9
anime_list.updateList(36456, { status: "completed", score: 9 });

API_MANGA_LIST

Initialize object

/*BEARER_TOKEN (ONLY THE TOKEN) = eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY4MWExNTIzYzBkZjI0MWNmNDlmZTg1Y2Y2MmQ5ZWU2ZDNjNDJlMGQ3ODIzN2I4ZjQ1NjkzMjUxZDdlYzhjZjIyYTVmNzdjZGY3MmJkMTkyIn0.ey...
 */
const manga_list = new API.API_LIST_MANGA(BEARER_TOKEN);

getListManga

(Display user manga list with current session)

Params:

user_name (String) (username) => default = "@me"
offset (Number) => default = 0
limit (Number) => default = 100
fields (Array) => default = structures (This is a mix of manga structure and status structure)

//Third page of results, 50 limit, 100-150,
manga_list.getList("@me", 150, 50);

deleteListManga

(Delete a manga entry from the list with current session)

Params:

manga_id (Number) => (manga_id that you want delete from the list)

//Delete Boku no Hero Academia from my manga list.
manga_list.deleteList(75989);

updateListManga

(Update manga entry from the list with current session)

Params:

manga_id (Number) => (manga_id that you want update from the list)
fieldsToUdpate (Object)(All the fields are optional) => { status: "reading" | "completed" | "on_hold" | "dropped" | "plan_to_read", is_rereading: true | false, score: 0-10, num_volumes_read: Number, num_chapters_read: Number, priority: 0-2, num_times_reread: Number, reread_value: 0-5, tags: String, comments: String }

//Update Boku no hero Academia entry with status completed and score 9
manga_list.updateList(75989, { status: "completed", score: 9 });

API_USER

Initialize object

/*BEARER_TOKEN (ONLY THE TOKEN) = eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY4MWExNTIzYzBkZjI0MWNmNDlmZTg1Y2Y2MmQ5ZWU2ZDNjNDJlMGQ3ODIzN2I4ZjQ1NjkzMjUxZDdlYzhjZjIyYTVmNzdjZGY3MmJkMTkyIn0.ey...
 */
const user = new API.API_USER(BEARER_TOKEN);

me

(Displays User information with current session)

Params:

fields (Array) => default = structures.user

user.me();

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Christian Andrés Bacho - @FarokStyle - christian.andres.1204@gmail.com

Project Link: https://github.com/Chris-Kode/myanimelist-api-v2

Files

README.md

Latest commit

History

README.md

File metadata and controls

MyAnimeList - API V2

Official documentation

Table of Contents

About The Project

Built With

Getting Started

TODO

Prerequisites

Install

Usage

Initial stepts before use the API

OAUTH

urlAuthorize

accessToken

refreshToken

API_ANIME

animes

anime

animeRanking

animeSeasonal

animeSuggestions

API_MANGA

mangas

manga

mangaRanking

API_ANIME_LIST

getListAnime

deleteListAnime

updateListAnime

API_MANGA_LIST

getListManga

deleteListManga

updateListManga

API_USER

me

Roadmap

Contributing

License

Contact