# 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.

App · Film, TV & Fandom · 18 actions. Web page: https://docs.lodol.com/docs/integrations/myanimelist

## Actions

### 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 ID (`anime_id`, number, required): 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.

- `anime` (object)

**Example output**

```json
{
  "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 username (`user_name`, text): Whose anime list to read. Leave blank for the connected account; another user's list works only if they made it public.
- Only this status (`status`, text): Return only entries with this status. One of: `watching`, `completed`, `on_hold` (On hold), `dropped`, `plan_to_watch` (Plan to watch).
- Sort by (`sort`, text): 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 many (`limit`, number): How many entries to return (1-1000). From 1 to 1000. Default: `10`.
- Skip (`offset`, number): 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.

- `count` (number): How many results were returned.
- `entries` (list): The list entries.
- `has_more` (true/false): Whether more results exist past this page.
- `next_offset` (number): The Skip value that fetches the next page, if any.
- `user_name` (text): Whose list was read.

**Example output**

```json
{
  "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**

- Ranking (`ranking_type`, text): 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 many (`limit`, number): How many anime to return (1-500). From 1 to 500. Default: `10`.
- Skip (`offset`, number): How many anime to skip before returning results, for paging. At least 0. Default: `0`.
- Include adult titles (`include_nsfw`, true/false): Include titles MyAnimeList flags as adult. Off by default. Default: `false`.

**Outputs**: Response envelope; the payload is in the "anime" field.

- `anime` (list): The ranked anime, best first.
- `count` (number): How many results were returned.
- `has_more` (true/false): Whether more results exist past this page.
- `next_offset` (number): The Skip value that fetches the next page, if any.
- `ranking_type` (text): The ranking that was read.

**Example output**

```json
{
  "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 ID (`topic_id`, number, required): 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 many (`limit`, number): How many posts to return (1-100). From 1 to 100. Default: `10`.
- Skip (`offset`, number): 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.

- `topic` (object)

**Example output**

```json
{
  "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 ID (`manga_id`, number, required): 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.

- `manga` (object)

**Example output**

```json
{
  "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 username (`user_name`, text): Whose manga list to read. Leave blank for the connected account; another user's list works only if they made it public.
- Only this status (`status`, text): Return only entries with this status. One of: `reading`, `completed`, `on_hold` (On hold), `dropped`, `plan_to_read` (Plan to read).
- Sort by (`sort`, text): 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 many (`limit`, number): How many entries to return (1-1000). From 1 to 1000. Default: `10`.
- Skip (`offset`, number): 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.

- `count` (number): How many results were returned.
- `entries` (list): The list entries.
- `has_more` (true/false): Whether more results exist past this page.
- `next_offset` (number): The Skip value that fetches the next page, if any.
- `user_name` (text): Whose list was read.

**Example output**

```json
{
  "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**

- Ranking (`ranking_type`, text): 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 many (`limit`, number): How many manga to return (1-500). From 1 to 500. Default: `10`.
- Skip (`offset`, number): How many manga to skip before returning results, for paging. At least 0. Default: `0`.
- Include adult titles (`include_nsfw`, true/false): Include titles MyAnimeList flags as adult. Off by default. Default: `false`.

**Outputs**: Response envelope; the payload is in the "manga" field.

- `count` (number): How many results were returned.
- `has_more` (true/false): Whether more results exist past this page.
- `manga` (list): The ranked manga, best first.
- `next_offset` (number): The Skip value that fetches the next page, if any.
- `ranking_type` (text): The ranking that was read.

**Example output**

```json
{
  "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.

- `user` (object)

**Example output**

```json
{
  "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**

- Year (`year`, number, required): The broadcast year, e.g. 2026. From 1917 to 2100.
- Season (`season`, text, required): 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 by (`sort`, text): 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 many (`limit`, number): How many anime to return (1-500). From 1 to 500. Default: `10`.
- Skip (`offset`, number): How many anime to skip before returning results, for paging. At least 0. Default: `0`.
- Include adult titles (`include_nsfw`, true/false): Include titles MyAnimeList flags as adult. Off by default. Default: `false`.

**Outputs**: Response envelope; the payload is in the "anime" field.

- `anime` (list): The season's anime.
- `count` (number): How many results were returned.
- `has_more` (true/false): Whether more results exist past this page.
- `next_offset` (number): The Skip value that fetches the next page, if any.
- `season` (text): Season read.
- `year` (number): Broadcast year read.

**Example output**

```json
{
  "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 many (`limit`, number): How many suggestions to return (1-100). From 1 to 100. Default: `10`.
- Skip (`offset`, number): 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.

- `anime` (list): The suggested anime that matched.
- `count` (number): How many results were returned.
- `has_more` (true/false): Whether more results exist past this page.
- `next_offset` (number): The Skip value that fetches the next page, if any.

**Example output**

```json
{
  "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.

- `categories` (list): The forum categories.
- `count` (number): How many categories were returned.

**Example output**

```json
{
  "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**

- Board (`board_id`, text): Only return topics from this forum board.
- Subboard (`subboard_id`, text): Only return topics from this subboard of the chosen board.
- Search phrase (`query`, text): Only return topics whose title matches this text.
- Started by (`topic_user_name`, text): Only return topics started by this username.
- Posted in by (`user_name`, text): Only return topics this username has posted in.
- How many (`limit`, number): How many topics to return (1-100). From 1 to 100. Default: `10`.
- Skip (`offset`, number): 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.

- `count` (number): How many results were returned.
- `has_more` (true/false): Whether more results exist past this page.
- `next_offset` (number): The Skip value that fetches the next page, if any.
- `topics` (list): The matching topics.

**Example output**

```json
{
  "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 ID (`anime_id`, number, required): The MyAnimeList anime id to remove from your list. At least 1.

**Outputs**: Confirmation that the list entry was deleted.

- `anime_id` (number): The anime that was removed.
- `deleted` (true/false): True once the entry is gone.

**Example output**

```json
{
  "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 ID (`manga_id`, number, required): The MyAnimeList manga id to remove from your list. At least 1.

**Outputs**: Confirmation that the list entry was deleted.

- `deleted` (true/false): True once the entry is gone.
- `manga_id` (number): The manga that was removed.

**Example output**

```json
{
  "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**

- Title (`query`, text, required): The anime title to search for.
- How many (`limit`, number): How many anime to return (1-100). From 1 to 100. Default: `10`.
- Skip (`offset`, number): How many anime to skip before returning results, for paging. At least 0. Default: `0`.
- Include adult titles (`include_nsfw`, true/false): Include titles MyAnimeList flags as adult. Off by default. Default: `false`.

**Outputs**: Response envelope; the payload is in the "anime" field.

- `anime` (list): The anime that matched.
- `count` (number): How many results were returned.
- `has_more` (true/false): Whether more results exist past this page.
- `next_offset` (number): The Skip value that fetches the next page, if any.

**Example output**

```json
{
  "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**

- Title (`query`, text, required): The manga title to search for.
- How many (`limit`, number): How many manga to return (1-100). From 1 to 100. Default: `10`.
- Skip (`offset`, number): How many manga to skip before returning results, for paging. At least 0. Default: `0`.
- Include adult titles (`include_nsfw`, true/false): Include titles MyAnimeList flags as adult. Off by default. Default: `false`.

**Outputs**: Response envelope; the payload is in the "manga" field.

- `count` (number): How many results were returned.
- `has_more` (true/false): Whether more results exist past this page.
- `manga` (list): The manga that matched.
- `next_offset` (number): The Skip value that fetches the next page, if any.

**Example output**

```json
{
  "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 ID (`anime_id`, number, required): The MyAnimeList anime id: the number in a myanimelist.net/anime/<id> URL, or the 'id' from a search step. At least 1.
- List status (`status`, text): Which of your lists the anime belongs on. One of: `watching`, `completed`, `on_hold` (On hold), `dropped`, `plan_to_watch` (Plan to watch).
- Your score (`score`, text): 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 watched (`num_watched_episodes`, number): How many episodes you have watched. At least 0.
- Currently rewatching (`is_rewatching`, true/false): Mark the entry as a rewatch in progress.
- Priority (`priority`, text): How high a priority this entry is on your list. One of: `0` (Low), `1` (Medium), `2` (High).
- Times rewatched (`num_times_rewatched`, number): How many times you have rewatched it. At least 0.
- Rewatch value (`rewatch_value`, text): 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 watching (`start_date`, date): The day you started watching it.
- Date finished watching (`finish_date`, date): The day you finished watching it.
- Tags (`tags`, list): Your own tags for this entry. Replaces any tags already set.
- Notes (`comments`, text): Your private notes on this entry.

**Outputs**: Response envelope; the payload is in the "list_status" field.

- `anime_id` (number): The anime that was updated.
- `list_status` (object): The entry as it now stands.

**Example output**

```json
{
  "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 ID (`manga_id`, number, required): The MyAnimeList manga id: the number in a myanimelist.net/manga/<id> URL, or the 'id' from a search step. At least 1.
- List status (`status`, text): Which of your lists the manga belongs on. One of: `reading`, `completed`, `on_hold` (On hold), `dropped`, `plan_to_read` (Plan to read).
- Your score (`score`, text): 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 read (`num_volumes_read`, number): How many volumes you have read. At least 0.
- Chapters read (`num_chapters_read`, number): How many chapters you have read. At least 0.
- Currently rereading (`is_rereading`, true/false): Mark the entry as a reread in progress.
- Priority (`priority`, text): How high a priority this entry is on your list. One of: `0` (Low), `1` (Medium), `2` (High).
- Times reread (`num_times_reread`, number): How many times you have reread it. At least 0.
- Reread value (`reread_value`, text): 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 reading (`start_date`, date): The day you started reading it.
- Date finished reading (`finish_date`, date): The day you finished reading it.
- Tags (`tags`, list): Your own tags for this entry. Replaces any tags already set.
- Notes (`comments`, text): Your private notes on this entry.

**Outputs**: Response envelope; the payload is in the "list_status" field.

- `list_status` (object): The entry as it now stands.
- `manga_id` (number): The manga that was updated.

**Example output**

```json
{
  "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
}
```