Official MAL API

Information

Welcome to the official MyAnimeList's API club! This is a place where developers can talk about the API, ask questions, look for help to fix bugs, suggest new features, and showcase their projects. Join us and subscribe to the club!


First time here?
No worries. You can start from this topic.
Don't hesitate to leave a comment or open a new discussion if you need help!


Quick access Current version of the API: v2
 API endpoint: https://api.myanimelist.net/v2
 OAuth2 authentication endpoint: https://myanimelist.net/v1/oauth2

 API panel
 Authentication & authorization docs (OAuth2)
 API docs (v2)
 API License and Developer Agreement

 Getting started
 Accessing public endpoints without OAuth2
 Unofficial Discord server

See All (1687)

Club Members

Displaying 5 of 262 topics | See All

Club Discussion

is there a endpoint that returns reviews of an anime? zavtot - Nov 17	0 replies	by zavtot »» Nov 17, 5:43 AM
I made a webapp to compare plan-to-watch lists daux - Apr 16, 2022	28 replies	by daux »» Nov 14, 12:47 PM
Sticky: [Nov 2021] Public information can now be accessed without authentication ( 1 2 ) ZeroCrystal - Nov 18, 2021	72 replies	by ZeroCrystal »» Oct 31, 9:32 AM
Is there an endpoint in the api that returns anime episode watch history? itszux - Oct 16	7 replies	by ZeroCrystal »» Oct 18, 9:15 AM
Selecting manga by serialization type isotonico - Sep 17	2 replies	by isotonico »» Sep 18, 7:24 PM

See All

Club Comments

SacredZenpie | Sep 5, 5:48 PM

Hi! Just a quick question, why is the API returning webp instead of jpg for some shows?

BytePusher | Jul 25, 6:59 AM

Hey everyone, I wanted to share here a web app that I've been working on and ask you for your thoughts and feedback.

It's an app that shows various insights, analyses and highlights of your anime list. Among some of it's features are a Spotify Wrapped-like yearly summary of your anime-watching activity, and a dissection of your plan-to-watch list into multiple categories so you can choose your next watch.

The app can be found at theanimeden.net and is optimized for both desktop and mobile! Here are some pics of the app's UI and features:

ZeroCrystal | Jun 30, 4:08 AM

@Zee530 It's true that you cannot sort them by title using the API, but it's very simple to do so from your client.
You can pass limit=500 to retrieve all anime for that season with a single request, and then you can sort them locally by any parameter you want.

Zee530 | Jun 28, 2:31 AM

@Jhiday, I see, thanks for clearing that up, i'm currently only needing publicly available data so X-MAL-CLIENT is good enough for me for now, thanks. Lastly, i'm trying to request for an entire season and according to the docs the only sort option listed is anime_score and anime_num_list_users, does this mean there is no way of sorting by stuff like title, start date, etc, as it appears on the seasonal site pages, thanks.

Jhiday | Jun 28, 2:16 AM

@Zee530 : there are two ways to authenticate with the API :
- X-MAL-CLIENT-ID is the simpler one, but limited to read-only public data
- "Authorization: Bearer" uses the more complex OAuth2 workflow (you can't use your MAL ClientId directly with it), which is detailed in one of the doc links atop the club. Since it has your app authenticate as a particular user, you have wider access for their data (both private, and in write mode).

Zee530 | Jun 28, 1:52 AM

Hi, still new to apis in general so apology in advance if this is too newb a question. The basic command to get details for a particular anime according to the docs is:

curl 'https://api.myanimelist.net/v2/anime/53410?fields=id,title,mean,num_list_users,media_type,status,num_episodes,start_season' \
-H 'Authorization: Bearer MY_TOKEN'

But this always returns a 401 error for me.

However after searching through one of the threads i saw this particular command:

request: 
    curl --request GET \
   --url https://api.myanimelist.net/v2/anime/53410?fields=id,title,mean,num_list_users,media_type,status,num_episodes,start_season
  --header 'X-MAL-CLIENT-ID: MY_TOKEN'\

...And this works for me everytime. I want to know what the difference between the two is and why one works as opposed to the other. For the console i'm using REST client to send the requests, an extension for VSCode, thanks in advance.

alexMadeira | May 29, 10:48 AM

Never mind, folks, it was a typo. Instead of 'Content-Type,' my code had 'Content_Type.' 🥲
I'll leave my previous comment in case it can be useful to someone.

alexMadeira | May 29, 8:38 AM

Hi, is anyone else facing an issue where the PUT method doesn't seem to update the value of the watched episodes?
I'm using the same code as before and hours ago it stopped working. Network status 200.
Body of the request: status=watching&score=0&num_watched_episodes=3&is_rewatching=false
Body of the response:
{
"status": "watching",
"score": 0,
"num_episodes_watched": 0,
"is_rewatching": false,
"updated_at": "2024-05-29T15:21:43+00:00",
"priority": 0,
"num_times_rewatched": 0,
"rewatch_value": 0,
"tags": [],
"comments": ""
}

Club in App

Chat features have been enabled for this club inside the official MAL app! Click here to get it.

Club Stats

Members: 1687

Pictures:

Category: Other

Created: Jul 14, 2009

Club Staff

Kineta (Secretary)

myanimelistllc (Secretary)

ZeroCrystal (Secretary)

Club Type

This is a public club.
Anyone can join and invite others to join. Club details, pictures, comments and club discussions can be viewed by any user, regardless of whether they are a member of the club or not.

Club Secretary can change the Club Type at any time. For more information on Club Types, click here.

Report Club

MoreTop Anime

MoreTop Airing Anime

MoreMost Popular Characters