MyAnimeList Builders¶

You can find anime using the features of MyAnimeList.net (MyAnimeList).

MyAnimeList Configuration

Configuring MyAnimeList in the config is required for any of these builders to function.

Builder	Description	Works with Movies	Works with Shows	Works with Playlists and Custom Sort
`mal_search`	Finds every anime in a MyAnimeList Search list
`mal_all`	Finds every anime in MyAnimeList's Top All Anime list
`mal_airing`	Finds every anime in MyAnimeList's Top Airing Anime list
`mal_upcoming`	Finds every anime in MyAnimeList's Top Upcoming Anime list
`mal_tv`	Finds every anime in MyAnimeList's Top Anime TV Series list
`mal_movie`	Finds every anime in MyAnimeList's Top Anime Movies list
`mal_ova`	Finds every anime in MyAnimeList's Top Anime OVA Series list
`mal_special`	Finds every anime in MyAnimeList's Top Anime Specials list
`mal_popular`	Finds every anime in MyAnimeList's Most Popular Anime list
`mal_favorite`	Finds every anime in MyAnimeList's Most Favorited Anime list
`mal_suggested`	Finds the suggested anime in by MyAnimeList for the authorized user
`mal_id`	Finds the anime specified by the MyAnimeList ID
`mal_userlist`	Finds anime in MyAnimeList User's Anime list the options are detailed below
`mal_season`	Finds anime in MyAnimeList's Seasonal Anime list the options are detailed below

MyAnimeList SearchMyAnimeList Top AllMyAnimeList Top AiringMyAnimeList Top UpcomingMyAnimeList Top TV SeriesMyAnimeList Top MoviesMyAnimeList Top OVA SeriesMyAnimeList Top SpecialsMyAnimeList Most PopularMyAnimeList Most FavoritedMyAnimeList SuggestedMyAnimeList IDMyAnimeList UserListMyAnimeList Seasonal

Gets every anime in a MyAnimeList search. The different sub-attributes are detailed below. At least one attribute is required.

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

Attribute	Description
`sort_by`	Description: Sort Order to return Values: `mal_id.desc`, `mal_id.asc`, `title.desc`, `title.asc`, `type.desc`, `type.asc`, `rating.desc`, `rating.asc`, `start_date.desc`, `start_date.asc`, `end_date.desc`, `end_date.asc`, `episodes.desc`, `episodes.asc`, `score.desc`, `score.asc`, `scored_by.desc`, `scored_by.asc`, `rank.desc`, `rank.asc`, `popularity.desc`, `popularity.asc`, `members.desc`, `members.asc`, `favorites.desc`, `favorites.asc`
`limit`	Description: Don't return more than this number Values: Number of Anime to query from MyAnimeList
`query`	Description: Text query to search for
`prefix`	Description: Results must begin with this prefix
`type`	Description: Type of Anime to search for Values: `tv`, `movie`, `ova`, `special`, `ona`, `music`
`status`	Description: Status to search for Values: `airing`, `complete`, `upcoming`
`genre`	Description: Comma-separated String of Genres to include using `,` for `AND` and `\|` for `OR` Values: Genre Name or ID
`genre.not`	Description: Comma-separated String of Genres to exclude using `,` for `AND` and `\|` for `OR` Values: Genre Name or ID
`studio`	Description: Comma-separated String of Genres to include using `,` for `AND` and `\|` for `OR` Values: Studio Name or ID
`content_rating`	Description: Content Rating to search for Values: `g`, `pg`, `pg13`, `r17`, `r`, `rx`
`score.gt`/`score.gte`	Description: Score must be greater than the given number Values: Float between `0.00`-`10.00`
`score.lt`/`score.lte`	Description: Score must be less than the given number Values: Float between `0.00`-`10.00`
`sfw`	Description: Results must be Safe for Work Value: `true`

Studio options can be found on MyAnimeList's Search Page.
Genre options can be found on MyAnimeList's Search Page.
To find the ID click on a Studio or Genre in the link above and there should be a number in the URL that's the id.
For example if the url is https://myanimelist.net/anime/producer/4/Bones the id would be 4 or if the url is https://myanimelist.net/anime/genre/1/Action the id would be 1.

Example MyAnimeList Search Builder(s)¶

collections:
  Top Action Anime:
    mal_search:
      limit: 100
      sort_by: score.desc
      genre: Action
    collection_order: custom
    sync_mode: sync

Gets every anime in MyAnimeList's Top Airing Anime list. (Maximum: 500)

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

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

Example MyAnimeList Top All Builder(s)¶

collections:
  Top All Anime:
    mal_all: 30
    collection_order: custom
    sync_mode: sync

Gets every anime in MyAnimeList's Top Airing Anime list. (Maximum: 500)

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

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

Example MyAnimeList Top Airing Builder(s)¶

collections:
  Top Airing Anime:
    mal_airing: 10
    collection_order: custom
    sync_mode: sync

Gets every anime in MyAnimeList's Top Upcoming Anime list. (Maximum: 500)

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

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

Example MyAnimeList Top Upcoming Builder(s)¶

collections:
  Top Upcoming Anime:
    mal_upcoming: 10
    collection_order: custom
    sync_mode: sync

Gets every anime in MyAnimeList's Top Anime TV Series list. (Maximum: 500)

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

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

Example MyAnimeList Top TV Series Builder(s)¶

collections:
  Top Anime TV Series:
    mal_tv: 20
    collection_order: custom
    sync_mode: sync

Gets every anime in MyAnimeList's Top Anime Movies list. (Maximum: 500)

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

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

Example MyAnimeList Top Movies Builder(s)¶

collections:
  Top Anime Movies:
    mal_movie: 20
    collection_order: custom
    sync_mode: sync

Gets every anime in MyAnimeList's Top Anime OVA Series list. (Maximum: 500)

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

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

Example MyAnimeList Top OVA Series Builder(s)¶

collections:
  Top Anime OVA Series:
    mal_ova: 20
    collection_order: custom
    sync_mode: sync

Gets every anime in MyAnimeList's Top Anime Specials list. (Maximum: 500)

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

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

Example MyAnimeList Top Specials Builder(s)¶

collections:
  Top Anime Specials:
    mal_special: 20
    collection_order: custom
    sync_mode: sync

Gets every anime in MyAnimeList's Most Popular Anime list. (Maximum: 500)

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

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

Example MyAnimeList Most Popular Builder(s)¶

collections:
  Most Popular Anime:
    mal_popular: 20
    collection_order: custom
    sync_mode: sync

Gets every anime in MyAnimeList's Most Favorited Anime list. (Maximum: 500)

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

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

Example MyAnimeList Most Favorited Builder(s)¶

collections:
  Most Favorited Anime:
    mal_favorite: 20
    collection_order: custom
    sync_mode: sync

Gets the suggested anime in by MyAnimeList for the authorized user. (Maximum: 100)

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

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

Example MyAnimeList Suggested Builder(s)¶

collections:
  Suggested Anime:
    mal_suggested: 20
    collection_order: custom
    sync_mode: sync

Gets the anime specified by the MyAnimeList ID.

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

Example MyAnimeList ID Builder(s)¶

collections:
  Cowboy Bebop:
    mal_id: 23, 219

Gets anime in MyAnimeList User's Anime list. The different sub-attributes are detailed below. The only required attribute is username

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

Attribute Description

username Description: A user's MyAnimeList Username or @me for the authorized user

status

Description: Status to search for
Default: all
Values:

`all`	All Anime List
`watching`	Currently Watching List
`completed`	Completed List
`on_hold`	On Hold List
`dropped`	Dropped List
`plan_to_watch`	Plan to Watch

sort_by

Description: Sort Order to return
Default: score
Values:

`score`	Sort by Score
`last_updated`	Sort by Last Updated
`title`	Sort by Anime Title
`start_date`	Sort by Start Date

limit Description: Don't return more than this number
Default: 100
Values: Number of Anime to query from MyAnimeList (max: 1000)

Example MyAnimeList UserList Builder(s)¶

collections:
  Currently Watching Anime:
    mal_userlist:
      username: "@me"
      status: watching
      sort_by: score
      limit: 500
    collection_order: custom
    sync_mode: sync

Gets anime in MyAnimeList's Seasonal Anime list the options are detailed below.

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

Attribute Description & Values

season

Description: Season to search
Default: current
Values:

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

year Description: Year to search
Default: Current Year
Values: Number between 1917 and the current year.

sort_by

Description: Sort Order
Default: members
Values:

`members`	Sort by Most Members
`score`	Sort by Score

limit Description: Don't return more than this number
Default: 100
Values: Number of Anime to query from MyAnimeList (max: 500)

starting_only Description: Return only anime that began airing in the selected season
Default: False
Values: True or False

Example MyAnimeList Seasonal Builder(s)¶

collections:
  Current Anime Season:
    mal_season:
      sort_by: members
      limit: 50
    collection_order: custom
    sync_mode: sync

collections:
  Fall 2020 Anime:
    mal_season:
      season: fall
      year: 2020
      limit: 50
    collection_order: custom
    sync_mode: sync