# MyAnimeList API: List top anime

> Lists MyAnimeList's top anime in rank order for a selected ranking (all, airing, upcoming, TV, movies or most popular), with English title, score, type, episodes, airing dates and members.

Unofficial. Not affiliated with or endorsed by MyAnimeList.

- Page: https://fous.com/methods/myanimelist.net/list-top-anime
- Method: `myanimelist.net/list_top_anime`, version 1
- Website: myanimelist.net
- Returns: rank, title, English title, score, type, episodes, aired dates, members, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `list` | string | no | `"upcoming"` | Ranking to list, for example movies. One of "all", "airing", "upcoming", "tv", "movies", "most_popular". Default "all". |
| `max_results` | integer | no | `55` | Number of anime to return, for example 50 (up to 200). Default 50. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "list": "upcoming",
  "max_results": 55
}
```

Its output:

```json
{
  "anime": [
    {
      "link": "https://myanimelist.net/anime/61987/Kusuriya_no_Hitorigoto_3rd_Season",
      "rank": 1,
      "type": "TV",
      "score": null,
      "title": "Kusuriya no Hitorigoto 3rd Season",
      "members": 157773,
      "episodes": null,
      "aired_dates": "Oct 2026 -",
      "english_title": "The Apothecary Diaries Season 3"
    },
    {
      "link": "https://myanimelist.net/anime/62516/Dandadan_3rd_Season",
      "rank": 2,
      "type": "TV",
      "score": null,
      "title": "Dandadan 3rd Season",
      "members": 144444,
      "episodes": null,
      "aired_dates": "2027 -",
      "english_title": "Dan Da Dan Season 3"
    },
    {
      "link": "https://myanimelist.net/anime/61990/Cyberpunk__Edgerunners_2",
      "rank": 3,
      "type": "ONA",
      "score": null,
      "title": "Cyberpunk: Edgerunners 2",
      "members": 123380,
      "episodes": 10,
      "aired_dates": "Oct 2026 -",
      "english_title": null
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"myanimelist.net/list_top_anime","input":{"list":"upcoming","max_results":55}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the 10 highest-ranked anime movies on MyAnimeList right now, with their scores?
- Show me the top 25 currently airing anime by rating, including episode counts and member numbers
- I need a list of the 100 most popular anime of all time, ranked by member count
- Which upcoming anime are ranked highest on MyAnimeList? Give me the top 30 with their air dates
- Pull the top 200 TV anime series in rank order with English titles, scores and links

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "list": {
      "enum": [
        "all",
        "airing",
        "upcoming",
        "tv",
        "movies",
        "most_popular"
      ],
      "type": "string",
      "default": "all",
      "description": "Ranking to list, for example movies."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Number of anime to return, for example 50 (up to 200)."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "anime"
  ],
  "properties": {
    "anime": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "title",
          "english_title",
          "score",
          "type",
          "episodes",
          "aired_dates",
          "members",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "rank": {
            "type": "integer"
          },
          "type": {
            "type": [
              "string",
              "null"
            ]
          },
          "score": {
            "type": [
              "number",
              "null"
            ],
            "description": "Score out of 10."
          },
          "title": {
            "type": "string"
          },
          "members": {
            "type": [
              "integer",
              "null"
            ]
          },
          "episodes": {
            "type": [
              "integer",
              "null"
            ]
          },
          "aired_dates": {
            "type": [
              "string",
              "null"
            ],
            "description": "Airing dates as displayed by MyAnimeList."
          },
          "english_title": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "description": "Anime in ranking order."
    }
  },
  "additionalProperties": false
}
```

## See more

- [MyAnimeList API: Look up an anime](https://fous.com/methods/myanimelist.net/get-anime.md): Looks up an anime on MyAnimeList by English or Japanese name, or by a MyAnimeList anime link. For ambiguous names it returns the most popular match.
- [MyAnimeList API: List seasonal anime](https://fous.com/methods/myanimelist.net/list-seasonal-anime.md): Lists anime in a MyAnimeList season sorted by members, with scores, episode counts, studio, genres and links. Continuing TV series are optional.
- [MyAnimeList API: Get manga](https://fous.com/methods/myanimelist.net/get-manga.md): Gets a manga, manhwa or light novel from MyAnimeList by title or by MyAnimeList link. When several entries share the top result's title, it returns the most popular one.
- [Bilibili API: List popular videos](https://fous.com/methods/bilibili.com/list-popular-videos.md): Lists the current Bilibili ranking overall or in a selected category, in rank order. The Movies ranking does not provide uploader, likes, length or BV numbers.
- [WEBTOON API: List rankings](https://fous.com/methods/webtoons.com/list-rankings.md): Lists popular or trending WEBTOON series in ranking order, with authors and displayed subscriber and view counts. Genre filtering keeps matching series from the public top 30.
- [IMDb API: List top charts](https://fous.com/methods/imdb.com/list-top-charts.md): Lists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles.
- [Letterboxd API: List popular films](https://fous.com/methods/letterboxd.com/list-popular-films.md): Lists Letterboxd films in popularity order for a week, month, year or all time, optionally filtered by genre and decade. Ratings and posters may be unavailable for some films.
- [Fandango API: List movies now playing or coming soon](https://fous.com/methods/fandango.com/list-now-playing.md): Lists Fandango movies now playing or coming soon in U.S. theaters, in Fandango's order, with release dates, age ratings, runtimes and Rotten Tomatoes scores when shown.
- [All MyAnimeList methods](https://fous.com/methods/myanimelist.net.md)
