Skip to main content

Anime

This is an object representing an Anime show. The API allows you to retrieve individual Anime as well as a list of them using various filters.

Endpoints
GET/v1/anime/:id
GET/v1/anime
GET/v1/random/anime/:count/:nsfw

The Anime object#

Attributes#


id integer#

Unique identifier for an Anime.


anilist_id integer nullable#

AniList external unique identifier.


mal_id integer nullable#

MyAnimeList external unique identifier.


format enum#

The show's format destination.

Possible format enum values
"TV": 0,"TV_SHORT": 1,"MOVIE": 2,"SPECIAL": 3,"OVA": 4,"ONA": 5,"MUSIC": 6

status enum#

The show's global release status.

Possible status enum values
"FINISHED": 0,"RELEASING": 1,"NOT_YET_RELEASED": 2,"CANCELLED": 3

titles map of strings#

A dictionary of the show's titles organized by localization.


descriptions map of strings#

A dictionary of the show's descriptions organized by localization.


start_date date nullable#

The show's global release date.


end_date date nullable#

The known show's global end date.


season_period enum#

The season on which the show has been released.

Possible season_period enum values
"WINTER": 0,"SPRING": 1,"SUMMER": 2,"FALL": 3,"UNKNOWN": 4

season_year integer nullable#

The year on which the show has been released.


episodes_count integer#

Number of episodes released for the show.


episode_duration integer nullable#

The show's episode average duration in minutes.


trailer_url string nullable#

External link to the show's trailer video. Possible services:

  • Youtube
  • Dailymotion

cover_image string#

The show's cover image.


cover_color string nullable#

The show's cover main color, in HEX format.


banner_image string nullable#

The show's banner image.


genres array of strings#

A collection of the show's associated genres. You can find all possible values here.


sequel integer nullable#

The show's precedent Anime's unique identifier in story-line.


prequel integer nullable#

The show's successive Anime's unique identifier in story-line.


score float#

The show's global appreciation indicator. Minimum value is 0 and maximum is 100.


Example#

Anime object example
{  "anilist_id": 21,  "mal_id": 21,  "format": 0,  "status": 1,  "titles": {      "en": "One Piece",      "jp": "ワンピース",      "it": "One Piece"  },  "descriptions": {      "en": "Gold Roger was known as the Pirate Ki...",      "it": "Monkey D. Luffy (Nel doppiaggio itali..."  },  "start_date": "1999-10-20T00:00:00Z",  "end_date": "1970-01-01T00:00:00Z",  "season_period": 3,  "season_year": 1999,  "episodes_count": 981,  "episode_duration": 24,  "cover_image": "https://s4.anilist.co/file/anilistcdn/media/anime/cov...",  "cover_color": "#e4a15d",  "banner_image": "https://s4.anilist.co/file/anilistcdn/media/anime/ba...",  "genres": [      "Action",      "Adventure",      "Comedy",      "Drama",      "Fantasy",      "Pirates",      "Shounen",      "Ensemble Cast",      "Super Power",      "Ships",      "Male Protagonist",      "Conspiracy",      "Tragedy",      "Crime",      "Time Skip",      "Politics",      "Boys' Love",      "War",      "Shapeshifting",      "Swordplay",      "Lost Civilization",      "Guns",      "Animals",      "Anachronism",      "Primarily Adult Cast",      "Cyborg",      "Skeleton",      "Espionage",      "Primarily Male Cast",      "Gender Bending",      "Ninja",      "Henshin",      "Real Robot",      "Anti-Hero",      "Mermaid",      "Battle Royale",      "Assassins",      "Tanned Skin",      "Zombie",      "Time Manipulation",      "Kuudere"  ],  "score": 86,  "id": 11}

Retrieve a specific Anime#

GET/v1/anime/:id

Retrieves an Anime show, based on its unique identifier.

Parameters#

No parameters.

Returns#

Returns an Anime object if a valid identifier was provided.

Try it#

This feature is not available on mobile.

Get a list of Anime#

GET/v1/anime

Returns a list of Anime objects. The Anime are returned sorted by score, with the most popular Anime appearing first.

Parameters#


title string optional#

A case-insensitive pattern filter on the list based on the titles field values.


anilist_id integer optional#

A filter on the list based on the anilist_id field value.


mal_id integer optional#

A filter on the list based on the mal_id field value.


formats array of enums optional#

A filter on the list based on the format field value.


status enum optional#

A filter on the list based on the status field value.


year integer optional#

A filter on the list based on the season_year field value.


season enum optional#

A filter on the list based on the season_period field value.


genres array of strings optional#

A case-sensitive pattern filter on the list based on the genres field values.


nsfw bool optional#

A filter on the list which excludes Anime classified as Not Safe For Work.


Returns#

Returns an array of Anime objects with a size based on the filter provided.

Try it#

This feature is not available on mobile.

Retrieve random Anime#

GET/v1/random/anime/:count/:nsfw

Retrieves a random Anime show list.

Parameters#

No parameters.

Returns#

Returns a random Anime list.

Try it#

This feature is not available on mobile.