README
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
Table of Contents
- About the Project
- Getting Started
- Usage
- Roadmap
- Contributing
- License
- Contact
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.
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