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 (1736)

Club Members

Displaying 5 of 271 topics | See All

Club Discussion

504 Error after some requests Krieffer - Mar 27	1 replies	by UncrownedGod »» 3 hours ago
Watch history A-Loli - Mar 27	0 replies	by A-Loli »» Yesterday, 6:10 AM
Search Anime SoonerThanLater_ - Mar 27	0 replies	by SoonerThanLater_ »» Yesterday, 1:44 AM
Sticky: [Nov 2021] Public information can now be accessed without authentication ( 1 2 ) ZeroCrystal - Nov 18, 2021	74 replies	by ZeroCrystal »» Mar 25, 8:22 AM
a bug in the anime_details->statistics->status l4z3x - Mar 24	0 replies	by l4z3x »» Mar 24, 4:23 AM

See All

Club Comments

ZeroCrystal | Feb 9, 7:35 AM

@Leriouch Just to be sure: the code verifier is identical to the one you previously used for the authentication step? Or did you perform any kind of hashing?

Also, if it's a JSON object, can you share the full response message you're getting from MAL?

Leriouch | Feb 6, 11:47 AM

I am currently on the step where I finish OAuth and receive my token by sending back the code I received. For some reason I get a 404 page not found. I am using the second format: POST https://myanimelist.net/v1/oauth2/token HTTP/1.1
Host: server.example.com
Content-Type: application/x-www-form-urlencoded

client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&grant_type=authorization_code
&code=AUTHORIZATION_CODE
&redirect_uri=YOUR_REDIRECT_URI
&code_verifier=YOUR_PKCE_CODE_VERIFIER

I have verified all the information from my client id and client secret. Here are some things I'm unsure of. Why is it giving me 404 page not found but when I use https://myanimelist.net/v1/oauth2/token for the post request it says authorization code is not an acceptable grant_type. Also is my code suppose to have the state appended to it while I use it. Other than than I have everything correct, my parameters are in the body, I have my headers and I don't see the problem.

MajorTanya | Jan 30, 5:55 AM

Hi, are there specific reason for why the OAuth endpoints return expires_in but neither a created_at nor a expires_at? Of course it's trivial to get the current system time in seconds and then store that alongside the token to remember expiry, but considering the JWT sent back already contains the exp claim (which is a timestamp, not a number of seconds), it seems odd to me that this available information is not also in the response body, alongside the tokens and expires_in data.

ZeroCrystal | Dec 11, 2024 11:38 AM

@iamkillingmyself: Assuming that the number of episodes is known (e.g., it won't work for One Piece), you just have to use the num_episodes field.

You can do this for a single anime:
https://api.myanimelist.net/v2/anime/57334?fields=num_episodes

Or for all seasonal series:
https://api.myanimelist.net/v2/anime/season/2024/winter?fields=num_episodes

iamkillingmyself | Dec 9, 2024 10:35 AM

how do i get the current episode number of an airing anime

ZeroCrystal | Dec 1, 2024 6:34 AM

@zeeshahali: Hi! There is no problem in filling in the form with dummy information for small personal projects.
For example, you can paste your MAL profile page as your homepage URL and http://localhost/oauth as your redirect URL.

zeeshahali | Nov 30, 2024 5:13 PM

Hi! I am trying to sign up for api, ain't gonna use it for some webapp or any other platform app. Just need it to update my list through python scripting. The form requires a lot of stuff to be filled and adding some random stuff doesn't work. How should I proceed with the form to get an api key?

SacredZenpie | Sep 5, 2024 5:48 PM

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

Club in App

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

Club Stats

Members: 1736

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