anime

Request

  • Base URL
    https://api.jikan.moe/v4
  • URL
    https://api.jikan.moe/v4/anime
  • Auth
    none declared

Query parameters

unapprovedboolean

This is a flag. When supplied it will include entries which are unapproved. Unapproved entries on MyAnimeList are those that are user submitted and have not yet been approved by MAL to show up on other pages. They will have their own specifc pages and are often removed resulting in a 404 error. You do not need to pass a value to it. e.g usage: ?unapproved

pageinteger
limitinteger
qstring
type'TV' | 'OVA' | 'Movie' | 'Special' | 'ONA' | 'Music' | 'CM' | 'PV' | 'TV Special'

Anime Type

scorenumber
min_scorenumber

Set a minimum score for results.

max_scorenumber

Set a maximum score for results

status'airing' | 'complete' | 'upcoming'

Available Anime statuses

rating'g' | 'pg' | 'pg13' | 'r17' | 'r' | 'rx'

Available Anime audience ratings<br><br><b>Ratings</b><br><ul><li>G - All Ages</li><li>PG - Children</li><li>PG-13 - Teens 13 or older</li><li>R - 17+ (violence & profanity)</li><li>R+ - Mild Nudity</li><li>Rx - Hentai</li></ul>

sfwboolean

Filter out Adult entries

genresstring

Filter by genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3

genres_excludestring

Exclude genre(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3

order_by'mal_id' | 'title' | 'start_date' | 'end_date' | 'episodes' | 'score' | 'scored_by' | 'rank' | 'popularity' | 'members' | 'favorites'

Available Anime order_by properties

sort'desc' | 'asc'

Search query sort direction

letterstring

Return entries starting with the given letter

producersstring

Filter by producer(s) IDs. Can pass multiple with a comma as a delimiter. e.g 1,2,3

start_datestring

Filter by starting date. Format: YYYY-MM-DD. e.g 2022, 2005-05, 2005-01-01

end_datestring

Filter by ending date. Format: YYYY-MM-DD. e.g 2022, 2005-05, 2005-01-01

Response

Returns search results for anime

Changes

    • breaking

      removed the enum value cm from the query request parameter type

    • breaking

      removed the enum value movie from the query request parameter type

    • breaking

      removed the enum value music from the query request parameter type

    • breaking

      removed the enum value ona from the query request parameter type

    • breaking

      removed the enum value ova from the query request parameter type

    • breaking

      removed the enum value pv from the query request parameter type

    • breaking

      removed the enum value special from the query request parameter type

    • breaking

      removed the enum value tv from the query request parameter type

    • breaking

      removed the enum value tv_special from the query request parameter type

    • breaking

      the /// response's property type changed from string to no type for status

    • info

      for the query request parameter type, the type was generalized from string to no type

    • info

      added to the /// response property allOf list for the response status

    • info

      removed the Movie enum value from the /// response property for the response status

    • info

      removed the Music enum value from the /// response property for the response status

    • info

      removed the ONA enum value from the /// response property for the response status

    • info

      removed the OVA enum value from the /// response property for the response status

    • info

      removed the Special enum value from the /// response property for the response status

    • info

      removed the TV enum value from the /// response property for the response status

    • info

      added the optional property ///// to the response with the status