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

Club Members

Displaying 5 of 253 topics | See All

Club Discussion

Fully open source HellCatNya - May 26	1 replies	by ZeroCrystal »» May 26, 3:04 PM
Unannounced API maintenance ? ( 1 2 ) Jhiday - Jan 31	73 replies	by AxtoMax »» Apr 26, 9:46 PM
Which endpoints support nsfw query param? crimson-megumin - Apr 21	2 replies	by crimson-megumin »» Apr 23, 2:29 PM
Cant build the URL tamcio_ - Dec 4, 2022	4 replies	by Jotzy »» Apr 22, 4:35 AM
I made a new anime recommendation system for MyAnimeList Asudox - Mar 21	4 replies	by Asudox »» Apr 11, 2:58 PM

See All

Club Comments

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": ""
}

ZeroCrystal | Mar 26, 8:27 AM

@INVADER056: It's not straightforward, but you can create a calendar from the seasonal data, with some post-processing on the client.

For example:

GET https://api.myanimelist.net/v2/anime/season/2024/winter?limit=500&fields=broadcast,start_date,end_date&nsfw=true

{
  "data": [
    {
      "node": {
        "id": 55866,
        "title": "Yubisaki to Renren",
        "main_picture": {...},
        "broadcast": {
          "day_of_the_week": "saturday",
          "start_time": "22:30"
        },
        "start_date": "2024-01-06",
        "end_date": "2024-03-23"
      }
    },
    {
      "node": {
        "id": 52701,
        "title": "Dungeon Meshi",
        "main_picture": {...},
        "broadcast": {
          "day_of_the_week": "thursday",
          "start_time": "22:30"
        },
        "start_date": "2024-01-04"
      }
    },
    [...]
}

You can retrieve all anime for a specific season with a single request. Then, you can filter them based on their airing days and store them as you prefer.

The broadcast object contains the airing day and time (Japan Standard Time) for an anime.
start_date and end_date, as the names suggest, tell you the first and last airing day for that series.

Be aware that all these fields are optional and could be missing for some anime, especially for the less popular ones.

INVADER056 | Mar 26, 3:51 AM

Hello @Zerocrystal in the api is there a wau where we can get the data for the anime episodes airing today? just like Jikan

ZeroCrystal | Mar 21, 12:47 PM

@INVADER056: The Code Verifier and the Code Challenge must be the same string since MAL only supports the plain code challenge method.
All's well that ends well.

INVADER056 | Mar 21, 11:34 AM

@ZeroCrystal tthanks for the doubt aparently the code verifer and the codechallenge should be set to same .It worked finall i can take a good sleep been trying this restlessly for 7 days

INVADER056 | Mar 21, 11:12 AM

@ZeroCrystal
The codeverifier and code challenger should be different or same I tried in both ways then also same error

ZeroCrystal | Mar 21, 11:09 AM

@INVADER056: A couple of questions:
• Are you certain that the Code Verifier you appended to the authorization URL is exactly the same as the one you're using later to issue a new access token?
• The Code Verifier and the Code Challenge are the exact same string? The Code Challenge must not be hashed (in MAL's case).

Club in App

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

Club Stats

Members: 1620

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