MyAnimeList

Track anime and manga on MyAnimeList: search the database, read title details, browse the top-anime and top-manga rankings and any broadcast season, and get the suggestions MyAnimeList picks for your account. Read and update your own anime and manga lists (status, score, episodes or chapters, start and finish dates, tags, and notes), remove entries, read any public profile's lists, browse the forums, and read your profile and watch statistics.

Actions

Action	What it does
Get anime details	Get one anime's full MyAnimeList record: synopsis, studios, broadcast slot, source material, rating, related titles, recommendations, and how members have it listed.
Get anime list	Read an anime list with each entry's status, score, and progress.
Get anime ranking	Get one of MyAnimeList's anime top lists: all-time, currently airing, upcoming, by format, most popular, or most favorited.
Get forum topic	Read one MyAnimeList forum topic: its title, its posts with author and body, and its poll results if it has one.
Get manga details	Get one manga's full MyAnimeList record: synopsis, authors, serializing magazine, related titles, and recommendations.
Get manga list	Read a manga list with each entry's status, score, and progress.
Get manga ranking	Get one of MyAnimeList's manga top lists: all-time, by format (manga, novels, one-shots, doujinshi, manhwa, manhua), most popular, or most favorited.
Get my profile	Get the connected MyAnimeList account's profile (username, join date, location, time zone) along with its anime statistics: how many titles sit in each list status, days watched, episode count, and mean score.
Get seasonal anime	List the anime of one broadcast season (for example Summer 2026), sorted by score or by how many members have it listed.
Get suggested anime	Get the anime MyAnimeList suggests for the connected account, based on what is already on its list.
List forum boards	List every MyAnimeList forum category with its boards and subboards, including the board ids the topic actions take.
List forum topics	Browse or search MyAnimeList forum topics: newest first, optionally narrowed to a board or subboard, a search phrase, the topic's author, or a user who posted in it.
Remove anime from list	Remove an anime from the connected account's list, discarding its score, progress, tags, and notes.
Remove manga from list	Remove a manga from the connected account's list, discarding its score, progress, tags, and notes.
Search anime	Search MyAnimeList's anime database by title and get each match's score, rank, episode count, season, genres, and your own list entry for it.
Search manga	Search MyAnimeList's manga database by title and get each match's score, rank, volume and chapter counts, genres, and your own list entry for it.
Update anime list entry	Add an anime to the connected account's list, or update the entry already there: status, score, episodes watched, dates, tags, and notes.
Update manga list entry	Add a manga to the connected account's list, or update the entry already there: status, score, volumes and chapters read, dates, tags, and notes.

Get anime details

Get one anime's full MyAnimeList record: synopsis, studios, broadcast slot, source material, rating, related titles, recommendations, and how members have it listed.

Inputs

Anime IDanime_idnumberRequired: The MyAnimeList anime id: the number in a myanimelist.net/anime/<id> URL, or the 'id' from a search step.At least 1.

Outputs

Response envelope; the payload is in the "anime" field.

animeobject

Example output

{
  "anime": {
    "average_episode_duration_seconds": 1440,
    "background": "Cowboy Bebop won a number of awards, including the Seiun Award.",
    "broadcast": {
      "day_of_the_week": "saturday",
      "start_time": "01:00"
    },
    "created_at": "2004-07-01T19:31:33+00:00",
    "end_date": "1999-04-24",
    "english_title": "Cowboy Bebop",
    "genres": [
      "Action",
      "Award Winning",
      "Sci-Fi"
    ],
    "id": 1,
    "japanese_title": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
    "main_picture": "https://cdn.myanimelist.net/images/anime/4/19644l.jpg",
    "mean": 8.75,
    "media_type": "tv",
    "my_list_status": {
      "comments": "Rewatch every winter.",
      "finish_date": "2026-02-15",
      "is_rewatching": false,
      "num_episodes_watched": 26,
      "num_times_rewatched": 0,
      "priority": 0,
      "rewatch_value": 0,
      "score": 9,
      "start_date": "2026-01-04",
      "status": "completed",
      "tags": [
        "classic"
      ],
      "updated_at": "2026-02-15T18:22:41+00:00"
    },
    "nsfw": "white",
    "num_episodes": 26,
    "num_list_users": 1893292,
    "num_scoring_users": 976252,
    "popularity": 43,
    "rank": 46,
    "rating": "r",
    "recommendations": [
      {
        "id": 205,
        "num_recommendations": 224,
        "title": "Samurai Champloo"
      }
    ],
    "related_anime": [
      {
        "id": 5,
        "relation": "Side story",
        "title": "Cowboy Bebop: Tengoku no Tobira"
      }
    ],
    "related_manga": [],
    "season": "Spring 1998",
    "source": "original",
    "start_date": "1998-04-03",
    "status": "finished_airing",
    "studios": [
      "Sunrise"
    ],
    "synopsis": "Crime is timeless. By the year 2071, humanity has expanded across the galaxy, filling the surface of other planets with settlements.",
    "title": "Cowboy Bebop",
    "updated_at": "2026-02-08T04:11:22+00:00",
    "url": "https://myanimelist.net/anime/1",
    "watch_statistics": {
      "completed": "1073691",
      "dropped": "40548",
      "on_hold": "89840",
      "plan_to_watch": "559283",
      "watching": "129930"
    }
  }
}

Get anime list

Read an anime list with each entry's status, score, and progress. Defaults to the connected account; any public profile can be read by username.

Inputs

MyAnimeList usernameuser_nametext: Whose anime list to read. Leave blank for the connected account; another user's list works only if they made it public.
Only this statusstatustext: Return only entries with this status.One of: watching, completed, on_hold (On hold), dropped, plan_to_watch (Plan to watch).
Sort bysorttext: How to order the entries.One of: list_score (Your score (high to low)), list_updated_at (Recently updated), anime_title (Title (A-Z)), anime_start_date (Newest first). Default: list_updated_at.
How manylimitnumber: How many entries to return (1-1000).From 1 to 1000. Default: 10.
Skipoffsetnumber: How many entries to skip before returning results, for paging.At least 0. Default: 0.

Outputs

Response envelope; the payload is in the "entries" field.

countnumber: How many results were returned.
entrieslist: The list entries.
has_moretrue/false: Whether more results exist past this page.
next_offsetnumber: The Skip value that fetches the next page, if any.
user_nametext: Whose list was read.

Example output

{
  "count": 1,
  "entries": [
    {
      "anime": {
        "end_date": "1999-04-24",
        "english_title": "Cowboy Bebop",
        "genres": [
          "Action",
          "Award Winning",
          "Sci-Fi"
        ],
        "id": 1,
        "japanese_title": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
        "main_picture": "https://cdn.myanimelist.net/images/anime/4/19644l.jpg",
        "mean": 8.75,
        "media_type": "tv",
        "my_list_status": {
          "comments": "Rewatch every winter.",
          "finish_date": "2026-02-15",
          "is_rewatching": false,
          "num_episodes_watched": 26,
          "num_times_rewatched": 0,
          "priority": 0,
          "rewatch_value": 0,
          "score": 9,
          "start_date": "2026-01-04",
          "status": "completed",
          "tags": [
            "classic"
          ],
          "updated_at": "2026-02-15T18:22:41+00:00"
        },
        "nsfw": "white",
        "num_episodes": 26,
        "num_list_users": 1893292,
        "popularity": 43,
        "rank": 46,
        "season": "Spring 1998",
        "start_date": "1998-04-03",
        "status": "finished_airing",
        "title": "Cowboy Bebop",
        "url": "https://myanimelist.net/anime/1"
      },
      "list_status": {
        "comments": "Rewatch every winter.",
        "finish_date": "2026-02-15",
        "is_rewatching": false,
        "num_episodes_watched": 26,
        "num_times_rewatched": 0,
        "priority": 0,
        "rewatch_value": 0,
        "score": 9,
        "start_date": "2026-01-04",
        "status": "completed",
        "tags": [
          "classic"
        ],
        "updated_at": "2026-02-15T18:22:41+00:00"
      }
    }
  ],
  "has_more": false,
  "next_offset": null,
  "user_name": "@me"
}

Get anime ranking

Get one of MyAnimeList's anime top lists: all-time, currently airing, upcoming, by format, most popular, or most favorited.

Inputs

Rankingranking_typetext: Which MyAnimeList top list to read.One of: all (Top anime (all)), airing (Top airing), upcoming (Top upcoming), tv (Top TV series), ova (Top OVAs), movie (Top movies), special (Top specials), bypopularity (Most popular), favorite (Most favorited). Default: all.
How manylimitnumber: How many anime to return (1-500).From 1 to 500. Default: 10.
Skipoffsetnumber: How many anime to skip before returning results, for paging.At least 0. Default: 0.
Include adult titlesinclude_nsfwtrue/false: Include titles MyAnimeList flags as adult. Off by default.Default: false.

Outputs

Response envelope; the payload is in the "anime" field.

animelist: The ranked anime, best first.
countnumber: How many results were returned.
has_moretrue/false: Whether more results exist past this page.
next_offsetnumber: The Skip value that fetches the next page, if any.
ranking_typetext: The ranking that was read.

Example output

{
  "anime": [
    {
      "end_date": "1999-04-24",
      "english_title": "Cowboy Bebop",
      "genres": [
        "Action",
        "Award Winning",
        "Sci-Fi"
      ],
      "id": 1,
      "japanese_title": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
      "main_picture": "https://cdn.myanimelist.net/images/anime/4/19644l.jpg",
      "mean": 8.75,
      "media_type": "tv",
      "my_list_status": {
        "comments": "Rewatch every winter.",
        "finish_date": "2026-02-15",
        "is_rewatching": false,
        "num_episodes_watched": 26,
        "num_times_rewatched": 0,
        "priority": 0,
        "rewatch_value": 0,
        "score": 9,
        "start_date": "2026-01-04",
        "status": "completed",
        "tags": [
          "classic"
        ],
        "updated_at": "2026-02-15T18:22:41+00:00"
      },
      "nsfw": "white",
      "num_episodes": 26,
      "num_list_users": 1893292,
      "popularity": 43,
      "rank": 46,
      "ranking_position": 1,
      "season": "Spring 1998",
      "start_date": "1998-04-03",
      "status": "finished_airing",
      "title": "Cowboy Bebop",
      "url": "https://myanimelist.net/anime/1"
    }
  ],
  "count": 1,
  "has_more": true,
  "next_offset": 10,
  "ranking_type": "all"
}

Get forum topic

Read one MyAnimeList forum topic: its title, its posts with author and body, and its poll results if it has one.

Inputs

Topic IDtopic_idnumberRequired: The forum topic id: the number in a myanimelist.net/forum/?topicid=<id> URL, or the 'id' from a topics step.At least 1.
How manylimitnumber: How many posts to return (1-100).From 1 to 100. Default: 10.
Skipoffsetnumber: How many posts to skip before returning results, for paging.At least 0. Default: 0.

Outputs

Response envelope; the payload is in the "topic" field.

topicobject

Example output

{
  "topic": {
    "has_more": true,
    "id": 2103574,
    "next_offset": 10,
    "poll": null,
    "post_count": 1,
    "posts": [
      {
        "body": "Post yours below!",
        "created_at": "2026-01-07T13:02:00+00:00",
        "created_by": "Xinil",
        "forum_avatar": "https://cdn.myanimelist.net/images/userimages/1.jpg",
        "id": 68410512,
        "number": 1,
        "signature": ""
      }
    ],
    "title": "What anime are you watching this season?",
    "url": "https://myanimelist.net/forum/?topicid=2103574"
  }
}

Get manga details

Get one manga's full MyAnimeList record: synopsis, authors, serializing magazine, related titles, and recommendations.

Inputs

Manga IDmanga_idnumberRequired: The MyAnimeList manga id: the number in a myanimelist.net/manga/<id> URL, or the 'id' from a search step.At least 1.

Outputs

Response envelope; the payload is in the "manga" field.

mangaobject

Example output

{
  "manga": {
    "authors": [
      "Kentarou Miura (Story & Art)"
    ],
    "background": "Berserk won the Award for Excellence at the Tezuka Osamu prize.",
    "created_at": "2007-06-04T02:20:00+00:00",
    "end_date": null,
    "english_title": "Berserk",
    "genres": [
      "Action",
      "Adventure",
      "Award Winning"
    ],
    "id": 2,
    "japanese_title": "\u30d9\u30eb\u30bb\u30eb\u30af",
    "main_picture": "https://cdn.myanimelist.net/images/manga/1/157897l.jpg",
    "mean": 9.47,
    "media_type": "manga",
    "my_list_status": {
      "comments": "Reading the Deluxe edition.",
      "finish_date": null,
      "is_rereading": false,
      "num_chapters_read": 364,
      "num_times_reread": 0,
      "num_volumes_read": 41,
      "priority": 1,
      "reread_value": 0,
      "score": 10,
      "start_date": "2025-11-02",
      "status": "reading",
      "tags": [
        "dark fantasy"
      ],
      "updated_at": "2026-03-01T09:04:12+00:00"
    },
    "nsfw": "white",
    "num_chapters": 0,
    "num_list_users": 660415,
    "num_scoring_users": 335162,
    "num_volumes": 0,
    "popularity": 2,
    "rank": 1,
    "recommendations": [
      {
        "id": 656,
        "num_recommendations": 168,
        "title": "Vagabond"
      }
    ],
    "related_anime": [
      {
        "id": 33,
        "relation": "Adaptation",
        "title": "Kenpuu Denki Berserk"
      }
    ],
    "related_manga": [],
    "serialization": [
      "Young Animal"
    ],
    "start_date": "1989-08-25",
    "status": "currently_publishing",
    "synopsis": "Guts, a former mercenary now known as the Black Swordsman, is out for revenge.",
    "title": "Berserk",
    "updated_at": "2026-02-27T11:00:15+00:00",
    "url": "https://myanimelist.net/manga/2"
  }
}

Get manga list

Read a manga list with each entry's status, score, and progress. Defaults to the connected account; any public profile can be read by username.

Inputs

MyAnimeList usernameuser_nametext: Whose manga list to read. Leave blank for the connected account; another user's list works only if they made it public.
Only this statusstatustext: Return only entries with this status.One of: reading, completed, on_hold (On hold), dropped, plan_to_read (Plan to read).
Sort bysorttext: How to order the entries.One of: list_score (Your score (high to low)), list_updated_at (Recently updated), manga_title (Title (A-Z)), manga_start_date (Newest first). Default: list_updated_at.
How manylimitnumber: How many entries to return (1-1000).From 1 to 1000. Default: 10.
Skipoffsetnumber: How many entries to skip before returning results, for paging.At least 0. Default: 0.

Outputs

Response envelope; the payload is in the "entries" field.

countnumber: How many results were returned.
entrieslist: The list entries.
has_moretrue/false: Whether more results exist past this page.
next_offsetnumber: The Skip value that fetches the next page, if any.
user_nametext: Whose list was read.

Example output

{
  "count": 1,
  "entries": [
    {
      "list_status": {
        "comments": "Reading the Deluxe edition.",
        "finish_date": null,
        "is_rereading": false,
        "num_chapters_read": 364,
        "num_times_reread": 0,
        "num_volumes_read": 41,
        "priority": 1,
        "reread_value": 0,
        "score": 10,
        "start_date": "2025-11-02",
        "status": "reading",
        "tags": [
          "dark fantasy"
        ],
        "updated_at": "2026-03-01T09:04:12+00:00"
      },
      "manga": {
        "end_date": null,
        "english_title": "Berserk",
        "genres": [
          "Action",
          "Adventure",
          "Award Winning"
        ],
        "id": 2,
        "japanese_title": "\u30d9\u30eb\u30bb\u30eb\u30af",
        "main_picture": "https://cdn.myanimelist.net/images/manga/1/157897l.jpg",
        "mean": 9.47,
        "media_type": "manga",
        "my_list_status": {
          "comments": "Reading the Deluxe edition.",
          "finish_date": null,
          "is_rereading": false,
          "num_chapters_read": 364,
          "num_times_reread": 0,
          "num_volumes_read": 41,
          "priority": 1,
          "reread_value": 0,
          "score": 10,
          "start_date": "2025-11-02",
          "status": "reading",
          "tags": [
            "dark fantasy"
          ],
          "updated_at": "2026-03-01T09:04:12+00:00"
        },
        "nsfw": "white",
        "num_chapters": 0,
        "num_list_users": 660415,
        "num_volumes": 0,
        "popularity": 2,
        "rank": 1,
        "start_date": "1989-08-25",
        "status": "currently_publishing",
        "title": "Berserk",
        "url": "https://myanimelist.net/manga/2"
      }
    }
  ],
  "has_more": false,
  "next_offset": null,
  "user_name": "@me"
}

Get manga ranking

Get one of MyAnimeList's manga top lists: all-time, by format (manga, novels, one-shots, doujinshi, manhwa, manhua), most popular, or most favorited.

Inputs

Rankingranking_typetext: Which MyAnimeList top list to read.One of: all (Top manga (all)), manga (Top manga), novels (Top novels), oneshots (Top one-shots), doujin (Top doujinshi), manhwa (Top manhwa), manhua (Top manhua), bypopularity (Most popular), favorite (Most favorited). Default: all.
How manylimitnumber: How many manga to return (1-500).From 1 to 500. Default: 10.
Skipoffsetnumber: How many manga to skip before returning results, for paging.At least 0. Default: 0.
Include adult titlesinclude_nsfwtrue/false: Include titles MyAnimeList flags as adult. Off by default.Default: false.

Outputs

Response envelope; the payload is in the "manga" field.

countnumber: How many results were returned.
has_moretrue/false: Whether more results exist past this page.
mangalist: The ranked manga, best first.
next_offsetnumber: The Skip value that fetches the next page, if any.
ranking_typetext: The ranking that was read.

Example output

{
  "count": 1,
  "has_more": true,
  "manga": [
    {
      "end_date": null,
      "english_title": "Berserk",
      "genres": [
        "Action",
        "Adventure",
        "Award Winning"
      ],
      "id": 2,
      "japanese_title": "\u30d9\u30eb\u30bb\u30eb\u30af",
      "main_picture": "https://cdn.myanimelist.net/images/manga/1/157897l.jpg",
      "mean": 9.47,
      "media_type": "manga",
      "my_list_status": {
        "comments": "Reading the Deluxe edition.",
        "finish_date": null,
        "is_rereading": false,
        "num_chapters_read": 364,
        "num_times_reread": 0,
        "num_volumes_read": 41,
        "priority": 1,
        "reread_value": 0,
        "score": 10,
        "start_date": "2025-11-02",
        "status": "reading",
        "tags": [
          "dark fantasy"
        ],
        "updated_at": "2026-03-01T09:04:12+00:00"
      },
      "nsfw": "white",
      "num_chapters": 0,
      "num_list_users": 660415,
      "num_volumes": 0,
      "popularity": 2,
      "rank": 1,
      "ranking_position": 1,
      "start_date": "1989-08-25",
      "status": "currently_publishing",
      "title": "Berserk",
      "url": "https://myanimelist.net/manga/2"
    }
  ],
  "next_offset": 10,
  "ranking_type": "all"
}

Get my profile

Get the connected MyAnimeList account's profile (username, join date, location, time zone) along with its anime statistics: how many titles sit in each list status, days watched, episode count, and mean score.

Inputs

None.

Outputs

Response envelope; the payload is in the "user" field.

userobject

Example output

{
  "user": {
    "anime_statistics": {
      "mean_score": 7.62,
      "num_days_watched": 118.4,
      "num_episodes": 8421,
      "num_items": 657,
      "num_items_completed": 428,
      "num_items_dropped": 21,
      "num_items_on_hold": 6,
      "num_items_plan_to_watch": 190,
      "num_items_watching": 12
    },
    "birthday": null,
    "gender": null,
    "id": 1,
    "is_supporter": true,
    "joined_at": "2004-11-05T00:00:00+00:00",
    "location": "California",
    "name": "Xinil",
    "picture": "https://cdn.myanimelist.net/images/userimages/1.jpg",
    "time_zone": "America/Los_Angeles",
    "url": "https://myanimelist.net/profile/Xinil"
  }
}

Get seasonal anime

List the anime of one broadcast season (for example Summer 2026), sorted by score or by how many members have it listed.

Inputs

YearyearnumberRequired: The broadcast year, e.g. 2026.From 1917 to 2100.
SeasonseasontextRequired: Which broadcast season of that year to list.One of: winter (Winter (Jan-Mar)), spring (Spring (Apr-Jun)), summer (Summer (Jul-Sep)), fall (Fall (Oct-Dec)).
Sort bysorttext: How to order the season's anime.One of: anime_score (Highest scored), anime_num_list_users (Most members). Default: anime_num_list_users.
How manylimitnumber: How many anime to return (1-500).From 1 to 500. Default: 10.
Skipoffsetnumber: How many anime to skip before returning results, for paging.At least 0. Default: 0.
Include adult titlesinclude_nsfwtrue/false: Include titles MyAnimeList flags as adult. Off by default.Default: false.

Outputs

Response envelope; the payload is in the "anime" field.

animelist: The season's anime.
countnumber: How many results were returned.
has_moretrue/false: Whether more results exist past this page.
next_offsetnumber: The Skip value that fetches the next page, if any.
seasontext: Season read.
yearnumber: Broadcast year read.

Example output

{
  "anime": [
    {
      "end_date": "1999-04-24",
      "english_title": "Cowboy Bebop",
      "genres": [
        "Action",
        "Award Winning",
        "Sci-Fi"
      ],
      "id": 1,
      "japanese_title": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
      "main_picture": "https://cdn.myanimelist.net/images/anime/4/19644l.jpg",
      "mean": 8.75,
      "media_type": "tv",
      "my_list_status": {
        "comments": "Rewatch every winter.",
        "finish_date": "2026-02-15",
        "is_rewatching": false,
        "num_episodes_watched": 26,
        "num_times_rewatched": 0,
        "priority": 0,
        "rewatch_value": 0,
        "score": 9,
        "start_date": "2026-01-04",
        "status": "completed",
        "tags": [
          "classic"
        ],
        "updated_at": "2026-02-15T18:22:41+00:00"
      },
      "nsfw": "white",
      "num_episodes": 26,
      "num_list_users": 1893292,
      "popularity": 43,
      "rank": 46,
      "season": "Spring 1998",
      "start_date": "1998-04-03",
      "status": "finished_airing",
      "title": "Cowboy Bebop",
      "url": "https://myanimelist.net/anime/1"
    }
  ],
  "count": 1,
  "has_more": true,
  "next_offset": 10,
  "season": "summer",
  "year": 2026
}

Get suggested anime

Get the anime MyAnimeList suggests for the connected account, based on what is already on its list. A brand-new account with no history gets an empty list back.

Inputs

How manylimitnumber: How many suggestions to return (1-100).From 1 to 100. Default: 10.
Skipoffsetnumber: How many suggestions to skip before returning results, for paging.At least 0. Default: 0.

Outputs

Response envelope; the payload is in the "anime" field.

animelist: The suggested anime that matched.
countnumber: How many results were returned.
has_moretrue/false: Whether more results exist past this page.
next_offsetnumber: The Skip value that fetches the next page, if any.

Example output

{
  "anime": [
    {
      "end_date": "1999-04-24",
      "english_title": "Cowboy Bebop",
      "genres": [
        "Action",
        "Award Winning",
        "Sci-Fi"
      ],
      "id": 1,
      "japanese_title": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
      "main_picture": "https://cdn.myanimelist.net/images/anime/4/19644l.jpg",
      "mean": 8.75,
      "media_type": "tv",
      "my_list_status": {
        "comments": "Rewatch every winter.",
        "finish_date": "2026-02-15",
        "is_rewatching": false,
        "num_episodes_watched": 26,
        "num_times_rewatched": 0,
        "priority": 0,
        "rewatch_value": 0,
        "score": 9,
        "start_date": "2026-01-04",
        "status": "completed",
        "tags": [
          "classic"
        ],
        "updated_at": "2026-02-15T18:22:41+00:00"
      },
      "nsfw": "white",
      "num_episodes": 26,
      "num_list_users": 1893292,
      "popularity": 43,
      "rank": 46,
      "season": "Spring 1998",
      "start_date": "1998-04-03",
      "status": "finished_airing",
      "title": "Cowboy Bebop",
      "url": "https://myanimelist.net/anime/1"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_offset": null
}

List forum boards

List every MyAnimeList forum category with its boards and subboards, including the board ids the topic actions take.

Inputs

None.

Outputs

Response envelope; the payload is in the "categories" field.

categorieslist: The forum categories.
countnumber: How many categories were returned.

Example output

{
  "categories": [
    {
      "boards": [
        {
          "description": "Site rules and frequent questions.",
          "id": 5,
          "subboards": [
            {
              "id": 2,
              "title": "Support"
            }
          ],
          "title": "MyAnimeList Guidelines & FAQ"
        }
      ],
      "title": "MyAnimeList"
    }
  ],
  "count": 1
}

List forum topics

Browse or search MyAnimeList forum topics: newest first, optionally narrowed to a board or subboard, a search phrase, the topic's author, or a user who posted in it.

Inputs

Boardboard_idtext: Only return topics from this forum board.
Subboardsubboard_idtext: Only return topics from this subboard of the chosen board.
Search phrasequerytext: Only return topics whose title matches this text.
Started bytopic_user_nametext: Only return topics started by this username.
Posted in byuser_nametext: Only return topics this username has posted in.
How manylimitnumber: How many topics to return (1-100).From 1 to 100. Default: 10.
Skipoffsetnumber: How many topics to skip before returning results, for paging.At least 0. Default: 0.

Outputs

Response envelope; the payload is in the "topics" field.

countnumber: How many results were returned.
has_moretrue/false: Whether more results exist past this page.
next_offsetnumber: The Skip value that fetches the next page, if any.
topicslist: The matching topics.

Example output

{
  "count": 1,
  "has_more": true,
  "next_offset": 10,
  "topics": [
    {
      "created_at": "2026-01-07T13:02:00+00:00",
      "created_by": "Xinil",
      "id": 2103574,
      "is_locked": false,
      "last_post_created_at": "2026-03-02T08:41:00+00:00",
      "last_post_created_by": "animefan2000",
      "number_of_posts": 482,
      "title": "What anime are you watching this season?",
      "url": "https://myanimelist.net/forum/?topicid=2103574"
    }
  ]
}

Remove anime from list

Remove an anime from the connected account's list, discarding its score, progress, tags, and notes.

Inputs

Anime IDanime_idnumberRequired: The MyAnimeList anime id to remove from your list.At least 1.

Outputs

Confirmation that the list entry was deleted.

anime_idnumber: The anime that was removed.
deletedtrue/false: True once the entry is gone.

Example output

{
  "anime_id": 1,
  "deleted": true
}

Remove manga from list

Remove a manga from the connected account's list, discarding its score, progress, tags, and notes.

Inputs

Manga IDmanga_idnumberRequired: The MyAnimeList manga id to remove from your list.At least 1.

Outputs

Confirmation that the list entry was deleted.

deletedtrue/false: True once the entry is gone.
manga_idnumber: The manga that was removed.

Example output

{
  "deleted": true,
  "manga_id": 2
}

Search anime

Search MyAnimeList's anime database by title and get each match's score, rank, episode count, season, genres, and your own list entry for it.

Inputs

TitlequerytextRequired: The anime title to search for.
How manylimitnumber: How many anime to return (1-100).From 1 to 100. Default: 10.
Skipoffsetnumber: How many anime to skip before returning results, for paging.At least 0. Default: 0.
Include adult titlesinclude_nsfwtrue/false: Include titles MyAnimeList flags as adult. Off by default.Default: false.

Outputs

Response envelope; the payload is in the "anime" field.

animelist: The anime that matched.
countnumber: How many results were returned.
has_moretrue/false: Whether more results exist past this page.
next_offsetnumber: The Skip value that fetches the next page, if any.

Example output

{
  "anime": [
    {
      "end_date": "1999-04-24",
      "english_title": "Cowboy Bebop",
      "genres": [
        "Action",
        "Award Winning",
        "Sci-Fi"
      ],
      "id": 1,
      "japanese_title": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
      "main_picture": "https://cdn.myanimelist.net/images/anime/4/19644l.jpg",
      "mean": 8.75,
      "media_type": "tv",
      "my_list_status": {
        "comments": "Rewatch every winter.",
        "finish_date": "2026-02-15",
        "is_rewatching": false,
        "num_episodes_watched": 26,
        "num_times_rewatched": 0,
        "priority": 0,
        "rewatch_value": 0,
        "score": 9,
        "start_date": "2026-01-04",
        "status": "completed",
        "tags": [
          "classic"
        ],
        "updated_at": "2026-02-15T18:22:41+00:00"
      },
      "nsfw": "white",
      "num_episodes": 26,
      "num_list_users": 1893292,
      "popularity": 43,
      "rank": 46,
      "season": "Spring 1998",
      "start_date": "1998-04-03",
      "status": "finished_airing",
      "title": "Cowboy Bebop",
      "url": "https://myanimelist.net/anime/1"
    }
  ],
  "count": 1,
  "has_more": true,
  "next_offset": 10
}

Search manga

Search MyAnimeList's manga database by title and get each match's score, rank, volume and chapter counts, genres, and your own list entry for it.

Inputs

TitlequerytextRequired: The manga title to search for.
How manylimitnumber: How many manga to return (1-100).From 1 to 100. Default: 10.
Skipoffsetnumber: How many manga to skip before returning results, for paging.At least 0. Default: 0.
Include adult titlesinclude_nsfwtrue/false: Include titles MyAnimeList flags as adult. Off by default.Default: false.

Outputs

Response envelope; the payload is in the "manga" field.

countnumber: How many results were returned.
has_moretrue/false: Whether more results exist past this page.
mangalist: The manga that matched.
next_offsetnumber: The Skip value that fetches the next page, if any.

Example output

{
  "count": 1,
  "has_more": true,
  "manga": [
    {
      "end_date": null,
      "english_title": "Berserk",
      "genres": [
        "Action",
        "Adventure",
        "Award Winning"
      ],
      "id": 2,
      "japanese_title": "\u30d9\u30eb\u30bb\u30eb\u30af",
      "main_picture": "https://cdn.myanimelist.net/images/manga/1/157897l.jpg",
      "mean": 9.47,
      "media_type": "manga",
      "my_list_status": {
        "comments": "Reading the Deluxe edition.",
        "finish_date": null,
        "is_rereading": false,
        "num_chapters_read": 364,
        "num_times_reread": 0,
        "num_volumes_read": 41,
        "priority": 1,
        "reread_value": 0,
        "score": 10,
        "start_date": "2025-11-02",
        "status": "reading",
        "tags": [
          "dark fantasy"
        ],
        "updated_at": "2026-03-01T09:04:12+00:00"
      },
      "nsfw": "white",
      "num_chapters": 0,
      "num_list_users": 660415,
      "num_volumes": 0,
      "popularity": 2,
      "rank": 1,
      "start_date": "1989-08-25",
      "status": "currently_publishing",
      "title": "Berserk",
      "url": "https://myanimelist.net/manga/2"
    }
  ],
  "next_offset": 10
}

Update anime list entry

Add an anime to the connected account's list, or update the entry already there: status, score, episodes watched, dates, tags, and notes. Only the fields you fill in are changed.

Inputs

Anime IDanime_idnumberRequired: The MyAnimeList anime id: the number in a myanimelist.net/anime/<id> URL, or the 'id' from a search step.At least 1.
List statusstatustext: Which of your lists the anime belongs on.One of: watching, completed, on_hold (On hold), dropped, plan_to_watch (Plan to watch).
Your scorescoretext: The score to give this anime, on MyAnimeList's 1-10 scale.One of: 0 (No score), 1 (1 - Appalling), 2 (2 - Horrible), 3 (3 - Very bad), 4 (4 - Bad), 5 (5 - Average), 6 (6 - Fine), 7 (7 - Good), 8 (8 - Very good), 9 (9 - Great), 10 (10 - Masterpiece).
Episodes watchednum_watched_episodesnumber: How many episodes you have watched.At least 0.
Currently rewatchingis_rewatchingtrue/false: Mark the entry as a rewatch in progress.
Priorityprioritytext: How high a priority this entry is on your list.One of: 0 (Low), 1 (Medium), 2 (High).
Times rewatchednum_times_rewatchednumber: How many times you have rewatched it.At least 0.
Rewatch valuerewatch_valuetext: How much you would want to rewatch it.One of: 0 (Never), 1 (Very low), 2 (Low), 3 (Medium), 4 (High), 5 (Very high).
Date started watchingstart_datedate: The day you started watching it.
Date finished watchingfinish_datedate: The day you finished watching it.
Tagstagslist: Your own tags for this entry. Replaces any tags already set.
Notescommentstext: Your private notes on this entry.

Outputs

Response envelope; the payload is in the "list_status" field.

anime_idnumber: The anime that was updated.
list_statusobject: The entry as it now stands.

Example output

{
  "anime_id": 1,
  "list_status": {
    "comments": "Rewatch every winter.",
    "finish_date": "2026-02-15",
    "is_rewatching": false,
    "num_episodes_watched": 26,
    "num_times_rewatched": 0,
    "priority": 0,
    "rewatch_value": 0,
    "score": 9,
    "start_date": "2026-01-04",
    "status": "completed",
    "tags": [
      "classic"
    ],
    "updated_at": "2026-02-15T18:22:41+00:00"
  }
}

Update manga list entry

Add a manga to the connected account's list, or update the entry already there: status, score, volumes and chapters read, dates, tags, and notes. Only the fields you fill in are changed.

Inputs

Manga IDmanga_idnumberRequired: The MyAnimeList manga id: the number in a myanimelist.net/manga/<id> URL, or the 'id' from a search step.At least 1.
List statusstatustext: Which of your lists the manga belongs on.One of: reading, completed, on_hold (On hold), dropped, plan_to_read (Plan to read).
Your scorescoretext: The score to give this manga, on MyAnimeList's 1-10 scale.One of: 0 (No score), 1 (1 - Appalling), 2 (2 - Horrible), 3 (3 - Very bad), 4 (4 - Bad), 5 (5 - Average), 6 (6 - Fine), 7 (7 - Good), 8 (8 - Very good), 9 (9 - Great), 10 (10 - Masterpiece).
Volumes readnum_volumes_readnumber: How many volumes you have read.At least 0.
Chapters readnum_chapters_readnumber: How many chapters you have read.At least 0.
Currently rereadingis_rereadingtrue/false: Mark the entry as a reread in progress.
Priorityprioritytext: How high a priority this entry is on your list.One of: 0 (Low), 1 (Medium), 2 (High).
Times rereadnum_times_rereadnumber: How many times you have reread it.At least 0.
Reread valuereread_valuetext: How much you would want to reread it.One of: 0 (Never), 1 (Very low), 2 (Low), 3 (Medium), 4 (High), 5 (Very high).
Date started readingstart_datedate: The day you started reading it.
Date finished readingfinish_datedate: The day you finished reading it.
Tagstagslist: Your own tags for this entry. Replaces any tags already set.
Notescommentstext: Your private notes on this entry.

Outputs

Response envelope; the payload is in the "list_status" field.

list_statusobject: The entry as it now stands.
manga_idnumber: The manga that was updated.

Example output

{
  "list_status": {
    "comments": "Reading the Deluxe edition.",
    "finish_date": null,
    "is_rereading": false,
    "num_chapters_read": 364,
    "num_times_reread": 0,
    "num_volumes_read": 41,
    "priority": 1,
    "reread_value": 0,
    "score": 10,
    "start_date": "2025-11-02",
    "status": "reading",
    "tags": [
      "dark fantasy"
    ],
    "updated_at": "2026-03-01T09:04:12+00:00"
  },
  "manga_id": 2
}

ActionsCopy Anchor Link

Get anime detailsCopy Anchor Link

Inputs

Outputs

Get anime listCopy Anchor Link

Inputs

Outputs

Get anime rankingCopy Anchor Link

Inputs

Outputs

Get forum topicCopy Anchor Link

Inputs

Outputs

Get manga detailsCopy Anchor Link

Inputs

Outputs

Get manga listCopy Anchor Link

Inputs

Outputs

Get manga rankingCopy Anchor Link

Inputs

Outputs

Get my profileCopy Anchor Link

Inputs

Outputs

Get seasonal animeCopy Anchor Link

Inputs

Outputs

Get suggested animeCopy Anchor Link

Inputs

Outputs

List forum boardsCopy Anchor Link

Inputs

Outputs

List forum topicsCopy Anchor Link

Inputs

Outputs

Remove anime from listCopy Anchor Link

Inputs

Outputs

Remove manga from listCopy Anchor Link

Inputs

Outputs

Search animeCopy Anchor Link

Inputs

Outputs

Search mangaCopy Anchor Link

Inputs

Outputs

Update anime list entryCopy Anchor Link

Inputs

Outputs

Update manga list entryCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get anime details

Get anime list

Get anime ranking

Get forum topic

Get manga details

Get manga list

Get manga ranking

Get my profile

Get seasonal anime

Get suggested anime

List forum boards

List forum topics

Remove anime from list

Remove manga from list

Search anime

Search manga

Update anime list entry

Update manga list entry