AniList Builders¶

You can find anime using the features of AniList.co (AniList).

No configuration is required for these builders.

Attribute	Description	Works with Movies	Works with Shows	Works with Playlists and Custom Sort
`anilist_top_rated`	Finds every anime in AniList’s Top Rated Anime list	✅	✅	✅
`anilist_popular`	Finds every anime in AniList’s Popular Anime list	✅	✅	✅
`anilist_trending`	Finds every anime in AniList’s Trending Anime list	✅	✅	✅
`anilist_relations`	Finds the anime specified by the AniList ID and every relation in its relation tree except Character and Other relations	✅	✅	❌
`anilist_studio`	Finds all anime specified by the AniList Studio ID	✅	✅	❌
`anilist_id`	Finds the anime specified by the AniList ID	✅	✅	❌
`anilist_userlist`	Finds the anime in AniList User’s Anime list the options are detailed below	✅	✅	✅
`anilist_search`	Finds the anime specified by the AniList search parameters provided	✅	✅	✅

AniList Top Rated¶

Finds every anime in AniList’s Top Rated Anime list.

The expected input is a single integer value of how many movies/shows to query.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

collections:
  Top Rated Anime:
    anilist_top_rated: 30
    collection_order: custom
    sync_mode: sync

AniList Popular¶

Finds every anime in AniList’s Popular Anime list.

The expected input is a single integer value of how many movies/shows to query.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

collections:
  Popular Anime:
    anilist_popular: 10
    collection_order: custom
    sync_mode: sync

AniList Relations¶

Finds the anime specified by the AniList ID and every relation in its relation tree except Character and Other relations.

The expected input is an AniList ID. Multiple values are supported as either a list or a comma-separated string.

collections:
  One Piece:
    anilist_relations: 21

AniList Studio¶

Finds all anime specified by the AniList Studio ID.

The expected input is an AniList ID. Multiple values are supported as either a list or a comma-separated string.

collections:
  Studio Ghibli:
    anilist_studio: 21

AniList ID¶

Finds the anime specified by the AniList ID.

The expected input is an AniList ID. Multiple values are supported as either a list or a comma-separated string.

collections:
  Cowboy Bebop:
    anilist_id: 23, 219

AniList UserList¶

Gets anime in AniList User’s Anime list. The different sub-attributes are detailed below.

Both username and list_name are required.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

Attribute

Description

username

Description: A user’s AniList Username

list_name

Description: A user’s AniList List Name

sort_by

Description: Sort Order to return
Default: score
Values:

`score`	Sort by User Score
`popularity`	Sort by Popularity
`status`	Sort by Status
`progress`	Sort by Progress
`last_updated`	Sort by Last Updated
`last_added`	Sort by Last Added
`start_date`	Sort by Start Date
`completed_date`	Sort by Completed Date

collections:
  Currently Watching Anime:
    anilist_userlist:
      username: Username
      list_name: Watching
      sort_by: score
    collection_order: custom
    sync_mode: sync

AniList Search¶

Finds the anime specified by the AniList Search the options are detailed below.

There are three fields per search option when using AniList’s Search just like Plex’s Advanced Filters in the Web UI. The first is the Attribute (what attribute you wish to search), the second is the Modifier (which modifier to use), and the third is the Term (actual term to search).

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

Special Attributes¶

Special attributes do not support any modifiers.

Special Attribute

Description & Values

sort_by

Description: How to sort the Anime
Default: score
Values:

`score`	Sort by Average Score
`popular`	Sort by Popularity
`trending`	Sort by Trending

limit

Description: Number of Anime to query
Values: Number greater or equal to 0 (use 0 or don’t use it at all for all anime)
Default: 0

search

Description: Text to search
Values: Any Text

season

Description: Season to search for
Default: current
Values:

`winter`	For winter season December, January, February
`spring`	For spring season March, April, May
`summer`	For summer season June, July, August
`fall`	For fall season September, October, November
`current`	For current Season

year

Description: Season year to search for
Default: Current Year
Values: Number between 1917 and next year or leave blank for the current year

min_tag_percent

Description: Minimum tag percentage for the Anime
Values: Number between 0-100

adult

Description: Search for or not for Adult Anime
Values: true or false

country

Description: Search for anime from a specific country
Values: ISO 3166-1 alpha-2 country code

source

Description: Uses the anime’s source to match
Values: original, manga, light_novel, visual_novel, video_game, other, novel, doujinshi, or anime

Tag Attributes¶

Tag attributes can be used with either no modifier or with .not.

String attributes can take multiple values as a list or a comma-separated string.

Tag Modifiers¶

Tag Modifier	Description
No Modifier	Matches every item where the attribute matches the given string
`.not`	Matches every item where the attribute does not match the given string

Tag Attributes¶

Tag Attribute	Description & Values
`format`	Description: Uses the anime’s format to match Values: `tv`, `short`, `movie`, `special`, `ova`, `ona`, `music`
`status`	Description: Uses the anime’s status to match Values: `finished`, `airing`, `not_yet_aired`, `cancelled`, `hiatus`
`genre`	Description: Uses the anime’s genre to match Values: Any Genre in the Genre Dropdown box on the AniList Search Page
`tag`	Description: Uses the anime’s tag to match Values: Any Tag in the Genre Dropdown box on the AniList Search Page
`tag_category`	Description: Uses the anime’s tag category to match Values: Any Tag Category in the Advanced Genres & Tag Filters Menu on the AniList Search Page

Date Attributes¶

Date attributes can be used with either .before, or .after.

No date attribute can take multiple values.

Date Modifiers¶

Date Modifier	Description
`.before`	Matches every item where the date attribute is before the given date Format: MM/DD/YYYY e.g. `01/01/2000`
`.after`	Matches every item where the date attribute is after the given date Format: MM/DD/YYYY e.g. `01/01/2000`

Date Attributes¶

Date Attributes	Description
`start`	Uses the anime start date attribute to match
`end`	Uses the anime end date attribute to match

Number Searches¶

Number attributes must use .gt, .gte, .lt, or .lte as a modifier.

No number attribute can take multiple values.

Number Modifiers¶

Number Modifier	Description
`.gt`	Matches every item where the number attribute is greater than the given number Format: number Example: `30`, `1995`, or `7.5`
`.gte`	Matches every item where the number attribute is greater than or equal to the given number Format: number Example: `30`, `1995`, or `7.5`
`.lt`	Matches every item where the number attribute is less than the given number Format: number Example: `30`, `1995`, or `7.5`
`.lte`	Matches every item where the number attribute is less than or equal to the given number Format: number Example: `30`, `1995`, or `7.5`

Number Attributes¶

Number Attribute	Description
`duration`	Description: Uses the duration attribute to match using minutes Restrictions: minimum: `1`
`episodes`	Description: Uses the number of episodes attribute to match Restrictions: minimum: `1`
`score`	Description: Uses the score attribute to match Restrictions: minimum: `1`
`popularity`	Description: Uses the popularity attribute to match Restrictions: minimum: `1`

AniList Search Examples¶

collections:
  Current Anime Season:
    anilist_search:
      season:
      year:
      sort_by: popular
    collection_order: custom
    sync_mode: sync

collections:
  Fall 2020 Anime:
    anilist_search:
      season: fall
      year: 2020
    collection_order: custom
    sync_mode: sync

collections:
  Pirates Anime:
    anilist_search:
      tag: Pirates
      sort_by: popular
    collection_order: custom
    sync_mode: sync

collections:
  Top Sports Anime:
    anilist_genre:
      genre: Sports
      limit: 20
      sort_by: popular
    collection_order: custom
    sync_mode: sync

AniList Builders¶

AniList Top Rated¶

AniList Popular¶

AniList Trending¶

AniList Relations¶

AniList Studio¶

AniList ID¶

AniList UserList¶

AniList Search¶

Special Attributes¶

Tag Attributes¶

Tag Modifiers¶

Tag Attributes¶

Date Attributes¶

Date Modifiers¶

Date Attributes¶

Number Searches¶

Number Modifiers¶

Number Attributes¶

AniList Search Examples¶