# AniList

> Search AniList's anime and manga database through its keyless public API: browse and filter anime and manga; look up characters, staff, studios, and public user profiles and lists; get airing schedules, reviews, recommendations, forum threads, and the genre and tag catalogs. No account or API key required.

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

## Actions

### Get airing schedule

Get anime episode airing times. Filter to upcoming episodes, a single anime, or a window of time, and sort by soonest first.

**Inputs**

- Anime ID (`media_id`, number): Only include episodes of this anime (its AniList id, as returned by Search anime). Leave blank for all anime.
- Upcoming only (`not_yet_aired`, true/false): Only include episodes that haven't aired yet.
- Airing after (`airing_after`, date and time): Only include episodes airing on or after this date and time.
- Airing before (`airing_before`, date and time): Only include episodes airing on or before this date and time.
- Sort by (`sort`, text): How to order the schedule. One of: `TIME` (Airing soonest), `TIME_DESC` (Airing latest), `EPISODE` (Episode (ascending)), `EPISODE_DESC` (Episode (descending)). Default: `TIME`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many episodes to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `airingSchedules` (list)
- `pageInfo` (object)

**Example output**

```json
{
  "airingSchedules": [
    {
      "airingAt": 1786613400,
      "episode": 21,
      "id": 412121,
      "media": {
        "coverImage": {
          "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/default.png"
        },
        "episodes": null,
        "format": "TV",
        "id": 209541,
        "siteUrl": "https://anilist.co/anime/209541",
        "title": {
          "english": null,
          "native": "\u30d7\u30ea\u30ad\u30e5\u30a2",
          "romaji": "Precure Season 3"
        }
      },
      "mediaId": 209541,
      "timeUntilAiring": 68400
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}
```

### Get anime

Get one anime's full details by its AniList id, including description, studios, tags, rankings, relations, external links, the next airing episode, and its main characters.

**Inputs**

- Anime ID (`media_id`, number, required): The anime's AniList id (e.g. 1), as returned by Search anime.

**Outputs**

- `media` (object)

**Example output**

```json
{
  "media": {
    "averageScore": 86,
    "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/anime/banner/1-OquNCNB6srGe.jpg",
    "chapters": null,
    "characters": {
      "edges": [
        {
          "node": {
            "id": 1,
            "image": {
              "large": "https://s4.anilist.co/file/anilistcdn/character/large/b1-ChxaldmieFlQ.png"
            },
            "name": {
              "full": "Spike Spiegel",
              "native": "\u30b9\u30d1\u30a4\u30af"
            },
            "siteUrl": "https://anilist.co/character/1"
          },
          "role": "MAIN"
        }
      ]
    },
    "countryOfOrigin": "JP",
    "coverImage": {
      "color": "#f16b50",
      "extraLarge": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/large/bx1-GCsPm7waJ4kS.png",
      "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/small/bx1-GCsPm7waJ4kS.png"
    },
    "description": "Enter a world in the distant future, where Bounty Hunters roam the solar system. Spike and Jet, bounty hunting partners, set out on journeys in an ever struggling effort to win bounty rewards to survive.",
    "duration": 24,
    "endDate": {
      "day": 24,
      "month": 4,
      "year": 1999
    },
    "episodes": 26,
    "externalLinks": [
      {
        "color": "#f47521",
        "icon": null,
        "language": "English",
        "site": "Crunchyroll",
        "type": "STREAMING",
        "url": "https://www.crunchyroll.com/cowboy-bebop"
      }
    ],
    "favourites": 33477,
    "format": "TV",
    "genres": [
      "Action",
      "Adventure",
      "Drama",
      "Sci-Fi"
    ],
    "hashtag": null,
    "id": 1,
    "idMal": 1,
    "isAdult": false,
    "isLicensed": true,
    "meanScore": 86,
    "nextAiringEpisode": null,
    "popularity": 462772,
    "rankings": [
      {
        "allTime": true,
        "context": "highest rated all time",
        "format": "TV",
        "rank": 1,
        "season": null,
        "type": "RATED",
        "year": null
      }
    ],
    "relations": {
      "edges": [
        {
          "node": {
            "format": "MOVIE",
            "id": 5,
            "title": {
              "english": "Cowboy Bebop: The Movie",
              "romaji": "Cowboy Bebop: Tengoku no Tobira"
            },
            "type": "ANIME"
          },
          "relationType": "SIDE_STORY"
        }
      ]
    },
    "season": "SPRING",
    "seasonYear": 1998,
    "siteUrl": "https://anilist.co/anime/1",
    "source": "ORIGINAL",
    "startDate": {
      "day": 3,
      "month": 4,
      "year": 1998
    },
    "status": "FINISHED",
    "studios": {
      "nodes": [
        {
          "id": 14,
          "name": "Sunrise",
          "siteUrl": "https://anilist.co/studio/14"
        }
      ]
    },
    "synonyms": [
      "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7"
    ],
    "tags": [
      {
        "category": "Setting-Universe",
        "description": "Involves outer space.",
        "id": 63,
        "isAdult": false,
        "isGeneralSpoiler": false,
        "isMediaSpoiler": false,
        "name": "Space",
        "rank": 90
      }
    ],
    "title": {
      "english": "Cowboy Bebop",
      "native": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
      "romaji": "Cowboy Bebop"
    },
    "trailer": {
      "id": "qig4KOK2R2g",
      "site": "youtube",
      "thumbnail": null
    },
    "type": "ANIME",
    "volumes": null
  }
}
```

### Get character

Get one character's full details by its AniList id, including description, gender, date of birth, and the media they appear in with their voice actors.

**Inputs**

- Character ID (`character_id`, number, required): The character's AniList id (e.g. 1), as returned by Search characters.

**Outputs**

- `character` (object)

**Example output**

```json
{
  "character": {
    "age": "27",
    "bloodType": null,
    "dateOfBirth": {
      "day": 26,
      "month": 6,
      "year": 2044
    },
    "description": "A tall and lean 27-year-old bounty hunter born on Mars.",
    "favourites": 14906,
    "gender": "Male",
    "id": 1,
    "image": {
      "large": "https://s4.anilist.co/file/anilistcdn/character/large/b1-ChxaldmieFlQ.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/character/medium/b1-ChxaldmieFlQ.png"
    },
    "media": {
      "edges": [
        {
          "characterRole": "MAIN",
          "node": {
            "format": "TV",
            "id": 1,
            "title": {
              "english": "Cowboy Bebop",
              "romaji": "Cowboy Bebop"
            },
            "type": "ANIME"
          },
          "voiceActors": [
            {
              "id": 95011,
              "name": {
                "full": "Kouichi Yamadera"
              }
            }
          ]
        }
      ]
    },
    "name": {
      "alternative": [
        "Swimming Bird"
      ],
      "full": "Spike Spiegel",
      "native": "\u30b9\u30d1\u30a4\u30af\u30fb\u30b9\u30d4\u30fc\u30b2\u30eb"
    },
    "siteUrl": "https://anilist.co/character/1"
  }
}
```

### Get forum thread

Get one forum thread's full body and metadata by its AniList id.

**Inputs**

- Thread ID (`thread_id`, number, required): The thread's AniList id, as returned by Search forum threads.

**Outputs**

- `thread` (object)

**Example output**

```json
{
  "thread": {
    "body": "What's your favorite anime of all time and why?",
    "categories": [
      {
        "id": 5,
        "name": "Anime"
      }
    ],
    "createdAt": 1480000000,
    "id": 617,
    "isLocked": false,
    "isSticky": false,
    "repliedAt": 1786500000,
    "replyCount": 3247,
    "siteUrl": "https://anilist.co/forum/thread/617",
    "title": "Your Favorite Anime / The Best Anime",
    "user": {
      "avatar": {
        "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
      },
      "id": 12345,
      "name": "Poster"
    },
    "viewCount": 45017
  }
}
```

### Get manga

Get one manga's full details by its AniList id, including description, tags, rankings, relations, external links, and its main characters.

**Inputs**

- Manga ID (`media_id`, number, required): The manga's AniList id (e.g. 30002), as returned by Search manga.

**Outputs**

- `media` (object)

**Example output**

```json
{
  "media": {
    "averageScore": 93,
    "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/manga/banner/30002-Iri2XCsg99Fp.jpg",
    "chapters": null,
    "countryOfOrigin": "JP",
    "coverImage": {
      "color": "#e4a15d",
      "extraLarge": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/large/bx30002-3Td1sMHW8Nyh.png",
      "large": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/medium/bx30002-3Td1sMHW8Nyh.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/small/bx30002-3Td1sMHW8Nyh.png"
    },
    "duration": null,
    "endDate": {
      "day": null,
      "month": null,
      "year": null
    },
    "episodes": null,
    "favourites": 42137,
    "format": "MANGA",
    "genres": [
      "Action",
      "Adventure",
      "Drama",
      "Fantasy",
      "Horror"
    ],
    "id": 30002,
    "idMal": 2,
    "isAdult": false,
    "meanScore": 93,
    "popularity": 141230,
    "season": null,
    "seasonYear": null,
    "siteUrl": "https://anilist.co/manga/30002",
    "source": "ORIGINAL",
    "startDate": {
      "day": 25,
      "month": 8,
      "year": 1989
    },
    "status": "RELEASING",
    "title": {
      "english": "Berserk",
      "native": "\u30d9\u30eb\u30bb\u30eb\u30af",
      "romaji": "Berserk"
    },
    "type": "MANGA",
    "volumes": null
  }
}
```

### Get recommendations

Get community 'if you liked this, try that' recommendations for an anime or manga by its AniList id.

**Inputs**

- Anime/Manga ID (`media_id`, number, required): The AniList id of the title to get recommendations for, as returned by Search anime or Search manga.
- Sort by (`sort`, text): How to order the recommendations. One of: `RATING_DESC` (Most recommended), `ID` (AniList ID). Default: `RATING_DESC`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many recommendations to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `pageInfo` (object)
- `recommendations` (list)

**Example output**

```json
{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "recommendations": [
    {
      "id": 1468,
      "media": {
        "coverImage": {
          "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png"
        },
        "format": "TV",
        "id": 1,
        "siteUrl": "https://anilist.co/anime/1",
        "title": {
          "english": "Cowboy Bebop",
          "romaji": "Cowboy Bebop"
        },
        "type": "ANIME"
      },
      "mediaRecommendation": {
        "averageScore": 79,
        "coverImage": {
          "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx6-hlBoHM6nsMKP.jpg"
        },
        "format": "TV",
        "id": 6,
        "siteUrl": "https://anilist.co/anime/6",
        "title": {
          "english": "Trigun",
          "romaji": "Trigun"
        },
        "type": "ANIME"
      },
      "rating": 655,
      "user": {
        "id": 12345,
        "name": "Recommender"
      }
    }
  ]
}
```

### Get review

Get one review's full text and score by its AniList id.

**Inputs**

- Review ID (`review_id`, number, required): The review's AniList id, as returned by List reviews.

**Outputs**

- `review` (object)

**Example output**

```json
{
  "review": {
    "body": "Cowboy Bebop remains one of the finest anime ever made...",
    "createdAt": 1500000000,
    "id": 4159,
    "media": {
      "id": 1,
      "title": {
        "english": "Cowboy Bebop",
        "romaji": "Cowboy Bebop"
      },
      "type": "ANIME"
    },
    "private": false,
    "rating": 412,
    "ratingAmount": 450,
    "score": 95,
    "siteUrl": "https://anilist.co/review/4159",
    "summary": "A timeless masterpiece.",
    "user": {
      "avatar": {
        "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
      },
      "id": 12345,
      "name": "Reviewer"
    }
  }
}
```

### Get site statistics

Get AniList's latest site-wide totals: how many anime, manga, characters, staff, studios, reviews, and users it tracks.

**Inputs**: None.

**Outputs**

- `statistics` (object)

**Example output**

```json
{
  "statistics": {
    "anime": {
      "change": 1,
      "count": 22506,
      "date": 1786543226
    },
    "characters": {
      "change": 60,
      "count": 289450,
      "date": 1786543226
    },
    "manga": {
      "change": 174,
      "count": 138216,
      "date": 1786543226
    },
    "reviews": {
      "change": 5,
      "count": 21500,
      "date": 1786543226
    },
    "staff": {
      "change": 20,
      "count": 128900,
      "date": 1786543226
    },
    "studios": {
      "change": 3,
      "count": 12800,
      "date": 1786543226
    },
    "users": {
      "change": 2160,
      "count": 3993292,
      "date": 1786543226
    }
  }
}
```

### Get staff member

Get one staff member's full details by their AniList id, including biography, occupations, the media they worked on, and characters they voiced.

**Inputs**

- Staff ID (`staff_id`, number, required): The staff member's AniList id (e.g. 95269), as returned by Search staff.

**Outputs**

- `staff` (object)

**Example output**

```json
{
  "staff": {
    "age": 85,
    "bloodType": null,
    "characters": {
      "nodes": []
    },
    "dateOfBirth": {
      "day": 5,
      "month": 1,
      "year": 1941
    },
    "dateOfDeath": {
      "day": null,
      "month": null,
      "year": null
    },
    "description": "Japanese director, animator, and manga artist, co-founder of Studio Ghibli.",
    "favourites": 15242,
    "gender": "Male",
    "homeTown": "Tokyo, Japan",
    "id": 95269,
    "image": {
      "large": "https://s4.anilist.co/file/anilistcdn/staff/large/n95269-emU4Nr9F8Gd8.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/staff/medium/n95269-emU4Nr9F8Gd8.png"
    },
    "languageV2": "Japanese",
    "name": {
      "full": "Hayao Miyazaki",
      "native": "\u5bae\u5d0e\u99ff"
    },
    "primaryOccupations": [
      "Director"
    ],
    "siteUrl": "https://anilist.co/staff/95269",
    "staffMedia": {
      "edges": [
        {
          "node": {
            "format": "MOVIE",
            "id": 129,
            "title": {
              "english": "Spirited Away",
              "romaji": "Sen to Chihiro no Kamikakushi"
            },
            "type": "ANIME"
          },
          "staffRole": "Director"
        }
      ]
    },
    "yearsActive": [
      1963
    ]
  }
}
```

### Get studio

Get one studio's details by its AniList id, including whether it's an animation studio and its most popular works.

**Inputs**

- Studio ID (`studio_id`, number, required): The studio's AniList id (e.g. 14), as returned by Search studios.

**Outputs**

- `studio` (object)

**Example output**

```json
{
  "studio": {
    "favourites": 6421,
    "id": 14,
    "isAnimationStudio": true,
    "media": {
      "nodes": [
        {
          "averageScore": 86,
          "format": "TV",
          "id": 1,
          "siteUrl": "https://anilist.co/anime/1",
          "startDate": {
            "year": 1998
          },
          "title": {
            "english": "Cowboy Bebop",
            "romaji": "Cowboy Bebop"
          }
        }
      ]
    },
    "name": "Sunrise",
    "siteUrl": "https://anilist.co/studio/14"
  }
}
```

### Get user profile

Get a public AniList user's profile by username, including their bio and anime and manga watching/reading statistics.

**Inputs**

- Username (`username`, text, required): The exact AniList username, e.g. 'AniList'.

**Outputs**

- `user` (object)

**Example output**

```json
{
  "user": {
    "about": "The AniList admin account.",
    "avatar": {
      "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/b6933956-785reg36BUwc.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/user/avatar/medium/b6933956-785reg36BUwc.png"
    },
    "bannerImage": null,
    "createdAt": 1550000000,
    "donatorBadge": null,
    "donatorTier": 0,
    "id": 6933956,
    "name": "AniList",
    "siteUrl": "https://anilist.co/user/6933956",
    "statistics": {
      "anime": {
        "count": 0,
        "episodesWatched": 0,
        "meanScore": 0,
        "minutesWatched": 0
      },
      "manga": {
        "chaptersRead": 0,
        "count": 0,
        "meanScore": 0,
        "volumesRead": 0
      }
    },
    "updatedAt": 1786500000
  }
}
```

### Get user's anime/manga list

Get a public AniList user's anime or manga list, grouped by status list, with each entry's score, progress, and dates. Returns one chunk at a time.

**Inputs**

- Username (`username`, text, required): The exact AniList username whose list to fetch.
- List (`media_type`, text, required): Which list to fetch: the user's anime list or manga list. One of: `ANIME`, `MANGA`.
- Status (`status`, text): Only include entries with this status. One of: `CURRENT` (Watching / Reading), `PLANNING`, `COMPLETED`, `DROPPED`, `PAUSED`, `REPEATING`.
- Sort by (`sort`, text): How to order the entries within each list. One of: `UPDATED_TIME_DESC` (Recently updated), `SCORE_DESC` (Highest scored), `PROGRESS_DESC` (Most progress), `STARTED_ON_DESC` (Recently started), `FINISHED_ON_DESC` (Recently finished), `MEDIA_POPULARITY_DESC` (Most popular), `ADDED_TIME_DESC` (Recently added). Default: `UPDATED_TIME_DESC`.
- Chunk number (`chunk`, number): Which chunk of the list to return (starts at 1). At least 1. Default: `1`.
- Entries per chunk (`per_chunk`, number): How many entries to return per chunk (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `hasNextChunk` (true/false)
- `lists` (list)
- `user` (object)

**Example output**

```json
{
  "hasNextChunk": false,
  "lists": [
    {
      "entries": [
        {
          "completedAt": {
            "day": 20,
            "month": 1,
            "year": 2021
          },
          "media": {
            "averageScore": 86,
            "chapters": null,
            "coverImage": {
              "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png"
            },
            "episodes": 26,
            "format": "TV",
            "id": 1,
            "siteUrl": "https://anilist.co/anime/1",
            "title": {
              "english": "Cowboy Bebop",
              "native": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
              "romaji": "Cowboy Bebop"
            },
            "type": "ANIME"
          },
          "progress": 26,
          "progressVolumes": null,
          "repeat": 1,
          "score": 95,
          "startedAt": {
            "day": 3,
            "month": 1,
            "year": 2021
          },
          "status": "COMPLETED",
          "updatedAt": 1611100000
        }
      ],
      "isCustomList": false,
      "name": "Completed",
      "status": "COMPLETED"
    }
  ],
  "user": {
    "avatar": {
      "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
    },
    "id": 5114268,
    "name": "Josh",
    "siteUrl": "https://anilist.co/user/5114268"
  }
}
```

### List activity feed

List the public AniList activity feed: text posts and list updates. Optionally filter to a single user or activity type.

**Inputs**

- User ID (`user_id`, number): Only include activity from this user (their AniList id, as returned by Search users). Leave blank for the global feed.
- Activity type (`activity_type`, text): Only include this kind of activity. One of: `TEXT` (Text posts), `ANIME_LIST` (Anime list updates), `MANGA_LIST` (Manga list updates), `MEDIA_LIST` (List updates (anime & manga)).
- Sort by (`sort`, text): How to order the activity. One of: `ID_DESC` (Newest first), `ID` (Oldest first), `PINNED` (Pinned first). Default: `ID_DESC`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many activities to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `activities` (list)
- `pageInfo` (object)

**Example output**

```json
{
  "activities": [
    {
      "__typename": "ListActivity",
      "createdAt": 1786600000,
      "id": 1134231454,
      "likeCount": 3,
      "media": {
        "coverImage": {
          "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png"
        },
        "format": "TV",
        "id": 1,
        "siteUrl": "https://anilist.co/anime/1",
        "title": {
          "english": "Cowboy Bebop",
          "romaji": "Cowboy Bebop"
        },
        "type": "ANIME"
      },
      "progress": "12",
      "replyCount": 0,
      "siteUrl": "https://anilist.co/activity/1134231454",
      "status": "watched episode",
      "type": "ANIME_LIST",
      "user": {
        "avatar": {
          "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
        },
        "id": 12345,
        "name": "Watcher"
      }
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}
```

### List genres

List every genre AniList uses to categorize anime and manga.

**Inputs**: None.

**Outputs**

- `genres` (list)

**Example output**

```json
{
  "genres": [
    "Action",
    "Adventure",
    "Comedy",
    "Drama",
    "Ecchi",
    "Fantasy",
    "Horror",
    "Mahou Shoujo",
    "Mecha",
    "Music",
    "Mystery",
    "Psychological",
    "Romance",
    "Sci-Fi",
    "Slice of Life",
    "Sports",
    "Supernatural",
    "Thriller"
  ]
}
```

### List reviews

List AniList user reviews, optionally for a specific anime or manga, sorted by helpfulness, score, or recency.

**Inputs**

- Anime/Manga ID (`media_id`, number): Only include reviews of this title (its AniList id). Leave blank for site-wide reviews.
- Type (`media_type`, text): Only include reviews of anime or of manga. One of: `ANIME`, `MANGA`.
- Sort by (`sort`, text): How to order the reviews. One of: `RATING_DESC` (Most helpful), `SCORE_DESC` (Highest score), `UPDATED_AT_DESC` (Recently updated), `ID_DESC` (Newest first). Default: `RATING_DESC`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many reviews to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `pageInfo` (object)
- `reviews` (list)

**Example output**

```json
{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "reviews": [
    {
      "createdAt": 1500000000,
      "id": 4159,
      "media": {
        "id": 1,
        "title": {
          "english": "Cowboy Bebop",
          "romaji": "Cowboy Bebop"
        },
        "type": "ANIME"
      },
      "rating": 412,
      "ratingAmount": 450,
      "score": 95,
      "siteUrl": "https://anilist.co/review/4159",
      "summary": "A timeless masterpiece.",
      "user": {
        "avatar": {
          "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
        },
        "id": 12345,
        "name": "Reviewer"
      }
    }
  ]
}
```

### List tags

List every descriptive tag AniList uses (themes, settings, demographics, and more), with each tag's category.

**Inputs**: None.

**Outputs**

- `tags` (list)

**Example output**

```json
{
  "tags": [
    {
      "category": "Setting-Universe",
      "description": "Involves outer space.",
      "id": 63,
      "isAdult": false,
      "isGeneralSpoiler": false,
      "name": "Space",
      "rank": 90
    }
  ]
}
```

### Search anime

Search AniList's anime database by title and filter by genre, tag, season, year, format, status, source, country, and score.

**Inputs**

- Title (`search`, text): The anime title to search for, e.g. 'Cowboy Bebop'.
- Genres (`genres`, list): Only include anime in these genres.
- Tags (`tags`, list): Only include anime with these AniList tags.
- Season (`season`, text): Only include anime from this release season. One of: `WINTER`, `SPRING`, `SUMMER`, `FALL`.
- Year (`season_year`, number): Only include anime from this release year. From 1940 to 2100.
- Format (`format`, text): Only include anime of this format. One of: `TV`, `TV_SHORT` (TV Short), `MOVIE`, `SPECIAL`, `OVA`, `ONA`, `MUSIC`.
- Airing status (`status`, text): Only include anime with this airing status. One of: `FINISHED`, `RELEASING`, `NOT_YET_RELEASED` (Not Yet Released), `CANCELLED`, `HIATUS`.
- Source material (`source`, text): Only include anime adapted from this source. One of: `ORIGINAL`, `MANGA`, `LIGHT_NOVEL` (Light Novel), `VISUAL_NOVEL` (Visual Novel), `VIDEO_GAME` (Video Game), `OTHER`, `NOVEL`, `DOUJINSHI`, `ANIME`, `WEB_NOVEL` (Web Novel), and 5 more.
- Country of origin (`country`, text): Only include anime from this country. One of: `JP` (Japan), `KR` (South Korea), `CN` (China), `TW` (Taiwan).
- Minimum score (`min_score`, number): Only include anime scoring above this value (0-100). From 0 to 100.
- Started after (`start_date_after`, date): Only include anime that started on or after this date.
- Started before (`start_date_before`, date): Only include anime that started on or before this date.
- Include adult content (`include_adult`, true/false): Include 18+ titles in the results. Off by default. Default: `false`.
- Sort by (`sort`, text): How to order the results. One of: `POPULARITY_DESC` (Most popular), `SCORE_DESC` (Highest rated), `TRENDING_DESC` (Trending now), `FAVOURITES_DESC` (Most favourited), `START_DATE_DESC` (Newest first), `START_DATE` (Oldest first), `TITLE_ROMAJI` (Title (A-Z)), `EPISODES_DESC` (Most episodes), `UPDATED_AT_DESC` (Recently updated), `ID` (AniList ID). Default: `POPULARITY_DESC`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many anime to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `media` (list)
- `pageInfo` (object)

**Example output**

```json
{
  "media": [
    {
      "averageScore": 86,
      "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/anime/banner/1-OquNCNB6srGe.jpg",
      "chapters": null,
      "countryOfOrigin": "JP",
      "coverImage": {
        "color": "#f16b50",
        "extraLarge": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/large/bx1-GCsPm7waJ4kS.png",
        "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png",
        "medium": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/small/bx1-GCsPm7waJ4kS.png"
      },
      "duration": 24,
      "endDate": {
        "day": 24,
        "month": 4,
        "year": 1999
      },
      "episodes": 26,
      "favourites": 33477,
      "format": "TV",
      "genres": [
        "Action",
        "Adventure",
        "Drama",
        "Sci-Fi"
      ],
      "id": 1,
      "idMal": 1,
      "isAdult": false,
      "meanScore": 86,
      "popularity": 462772,
      "season": "SPRING",
      "seasonYear": 1998,
      "siteUrl": "https://anilist.co/anime/1",
      "source": "ORIGINAL",
      "startDate": {
        "day": 3,
        "month": 4,
        "year": 1998
      },
      "status": "FINISHED",
      "title": {
        "english": "Cowboy Bebop",
        "native": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
        "romaji": "Cowboy Bebop"
      },
      "type": "ANIME",
      "volumes": null
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}
```

### Search characters

Search AniList's database of anime and manga characters by name.

**Inputs**

- Name (`search`, text, required): The character name to search for, e.g. 'Spike Spiegel'.
- Sort by (`sort`, text): How to order the results. One of: `SEARCH_MATCH` (Best match), `FAVOURITES_DESC` (Most favourited), `ID` (AniList ID). Default: `SEARCH_MATCH`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many characters to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `characters` (list)
- `pageInfo` (object)

**Example output**

```json
{
  "characters": [
    {
      "favourites": 14906,
      "id": 1,
      "image": {
        "large": "https://s4.anilist.co/file/anilistcdn/character/large/b1-ChxaldmieFlQ.png"
      },
      "name": {
        "full": "Spike Spiegel",
        "native": "\u30b9\u30d1\u30a4\u30af\u30fb\u30b9\u30d4\u30fc\u30b2\u30eb"
      },
      "siteUrl": "https://anilist.co/character/1"
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}
```

### Search forum threads

Search AniList forum threads by keyword, or list the most active threads, with reply and view counts.

**Inputs**

- Keyword (`search`, text): Search threads by title/body keyword. Leave blank to list threads.
- Sort by (`sort`, text): How to order the threads. One of: `SEARCH_MATCH` (Best match), `REPLIED_AT_DESC` (Recently replied), `REPLY_COUNT_DESC` (Most replies), `VIEW_COUNT_DESC` (Most viewed), `UPDATED_AT_DESC` (Recently updated), `ID_DESC` (Newest first). Default: `REPLIED_AT_DESC`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many threads to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `pageInfo` (object)
- `threads` (list)

**Example output**

```json
{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "threads": [
    {
      "categories": [
        {
          "id": 5,
          "name": "Anime"
        }
      ],
      "createdAt": 1480000000,
      "id": 617,
      "isLocked": false,
      "isSticky": false,
      "repliedAt": 1786500000,
      "replyCount": 3247,
      "siteUrl": "https://anilist.co/forum/thread/617",
      "title": "Your Favorite Anime / The Best Anime",
      "user": {
        "avatar": {
          "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
        },
        "id": 12345,
        "name": "Poster"
      },
      "viewCount": 45017
    }
  ]
}
```

### Search manga

Search AniList's manga database by title and filter by genre, tag, format, status, source, country, and score.

**Inputs**

- Title (`search`, text): The manga title to search for, e.g. 'Berserk'.
- Genres (`genres`, list): Only include manga in these genres.
- Tags (`tags`, list): Only include manga with these AniList tags.
- Format (`format`, text): Only include manga of this format. One of: `MANGA`, `NOVEL` (Light Novel), `ONE_SHOT` (One Shot).
- Publishing status (`status`, text): Only include manga with this publishing status. One of: `FINISHED`, `RELEASING`, `NOT_YET_RELEASED` (Not Yet Released), `CANCELLED`, `HIATUS`.
- Source material (`source`, text): Only include manga adapted from this source. One of: `ORIGINAL`, `MANGA`, `LIGHT_NOVEL` (Light Novel), `VISUAL_NOVEL` (Visual Novel), `VIDEO_GAME` (Video Game), `OTHER`, `NOVEL`, `DOUJINSHI`, `ANIME`, `WEB_NOVEL` (Web Novel), and 5 more.
- Country of origin (`country`, text): Only include titles from this country (e.g. Japan for manga, South Korea for manhwa, China for manhua). One of: `JP` (Japan), `KR` (South Korea), `CN` (China), `TW` (Taiwan).
- Minimum score (`min_score`, number): Only include manga scoring above this value (0-100). From 0 to 100.
- Started after (`start_date_after`, date): Only include manga that started on or after this date.
- Started before (`start_date_before`, date): Only include manga that started on or before this date.
- Include adult content (`include_adult`, true/false): Include 18+ titles in the results. Off by default. Default: `false`.
- Sort by (`sort`, text): How to order the results. One of: `POPULARITY_DESC` (Most popular), `SCORE_DESC` (Highest rated), `TRENDING_DESC` (Trending now), `FAVOURITES_DESC` (Most favourited), `START_DATE_DESC` (Newest first), `START_DATE` (Oldest first), `TITLE_ROMAJI` (Title (A-Z)), `EPISODES_DESC` (Most episodes), `UPDATED_AT_DESC` (Recently updated), `ID` (AniList ID). Default: `POPULARITY_DESC`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many manga to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `media` (list)
- `pageInfo` (object)

**Example output**

```json
{
  "media": [
    {
      "averageScore": 93,
      "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/manga/banner/30002-Iri2XCsg99Fp.jpg",
      "chapters": null,
      "countryOfOrigin": "JP",
      "coverImage": {
        "color": "#e4a15d",
        "extraLarge": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/large/bx30002-3Td1sMHW8Nyh.png",
        "large": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/medium/bx30002-3Td1sMHW8Nyh.png",
        "medium": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/small/bx30002-3Td1sMHW8Nyh.png"
      },
      "duration": null,
      "endDate": {
        "day": null,
        "month": null,
        "year": null
      },
      "episodes": null,
      "favourites": 42137,
      "format": "MANGA",
      "genres": [
        "Action",
        "Adventure",
        "Drama",
        "Fantasy",
        "Horror"
      ],
      "id": 30002,
      "idMal": 2,
      "isAdult": false,
      "meanScore": 93,
      "popularity": 141230,
      "season": null,
      "seasonYear": null,
      "siteUrl": "https://anilist.co/manga/30002",
      "source": "ORIGINAL",
      "startDate": {
        "day": 25,
        "month": 8,
        "year": 1989
      },
      "status": "RELEASING",
      "title": {
        "english": "Berserk",
        "native": "\u30d9\u30eb\u30bb\u30eb\u30af",
        "romaji": "Berserk"
      },
      "type": "MANGA",
      "volumes": null
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}
```

### Search staff

Search AniList's database of staff and voice actors by name (directors, writers, animators, seiyuu, and more).

**Inputs**

- Name (`search`, text, required): The staff member's name to search for, e.g. 'Hayao Miyazaki'.
- Sort by (`sort`, text): How to order the results. One of: `SEARCH_MATCH` (Best match), `FAVOURITES_DESC` (Most favourited), `ID` (AniList ID). Default: `SEARCH_MATCH`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many staff members to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `pageInfo` (object)
- `staff` (list)

**Example output**

```json
{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "staff": [
    {
      "favourites": 15242,
      "id": 95269,
      "image": {
        "large": "https://s4.anilist.co/file/anilistcdn/staff/large/n95269-emU4Nr9F8Gd8.png"
      },
      "name": {
        "full": "Hayao Miyazaki",
        "native": "\u5bae\u5d0e\u99ff"
      },
      "primaryOccupations": [
        "Director"
      ],
      "siteUrl": "https://anilist.co/staff/95269"
    }
  ]
}
```

### Search studios

Search AniList's database of animation studios and producers by name.

**Inputs**

- Name (`search`, text, required): The studio name to search for, e.g. 'ufotable'.
- Sort by (`sort`, text): How to order the results. One of: `SEARCH_MATCH` (Best match), `FAVOURITES_DESC` (Most favourited), `NAME` (Name (A-Z)), `ID` (AniList ID). Default: `SEARCH_MATCH`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many studios to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `pageInfo` (object)
- `studios` (list)

**Example output**

```json
{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "studios": [
    {
      "favourites": 6421,
      "id": 14,
      "isAnimationStudio": true,
      "name": "Sunrise",
      "siteUrl": "https://anilist.co/studio/14"
    }
  ]
}
```

### Search users

Search AniList's public user profiles by username.

**Inputs**

- Username (`search`, text, required): The username to search for.
- Sort by (`sort`, text): How to order the results. One of: `SEARCH_MATCH` (Best match), `USERNAME` (Username (A-Z)), `WATCHED_TIME_DESC` (Most anime watched), `CHAPTERS_READ_DESC` (Most chapters read), `ID` (AniList ID). Default: `SEARCH_MATCH`.
- Page number (`page`, number): Which page of results to return (starts at 1). At least 1. Default: `1`.
- How many (`per_page`, number): How many users to return per page (1-50). From 1 to 50. Default: `10`.

**Outputs**

- `pageInfo` (object)
- `users` (list)

**Example output**

```json
{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "users": [
    {
      "avatar": {
        "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/b6933956-785reg36BUwc.png"
      },
      "bannerImage": null,
      "id": 6933956,
      "name": "AniList",
      "siteUrl": "https://anilist.co/user/6933956"
    }
  ]
}
```