Series

A series is either an anime or manga. {series_type} is either ‘anime’ or ‘manga’.

Series Model

Key Type Example/Possible values Notes In small model
id int 1   Yes
series_type string anime or manga   Yes
title_romaji string Kangoku Gakuen   Yes
title_english string Prison School When no English title is available, the romaji title will fill this value. Yes
title_japanese string   When no Japanese title is available, the romaji title will fill this value. Yes
type string (See string media types below)   Yes
start_date string|null Deprecated. (See deprecated dates below) Deprecated. No
end_date string|null Deprecated. (See deprecated dates below) Deprecated. No
start_date_fuzzy int|null (See fuzzy dates below)   Yes
end_date_fuzzy int|null (See fuzzy dates below)   Yes
season int|null 164 First 2 numbers are the year (16 is 2016). Last number is the season starting at 1 (3 is Summer). No
description string|null   Description of series. No
synonyms array (strings) [“The Prison School”] Alternative titles. Yes
genres array (strings) (See genres below)   Yes
adult bool True True for adult series (Hentai). This does not include ecchi. Yes
average_score double 67.8 0-100 Yes
popularity int 15340 Number of users with series on their list. Yes
favourite bool true If the current authenticated user has favorited the series. False if not authenticated. No
image_url_sml string http://cdn.anilist.co/img/dir/anime/sml/9756.jpg Image url. 24x39* (Not available for manga) Yes
image_url_med string http://cdn.anilist.co/img/dir/anime/med/9756.jpg Image url. 93x133* Yes
image_url_lge string http://cdn.anilist.co/img/dir/anime/reg/9756.jpg Image url. 225x323* Yes
image_url_banner string|null http://cdn.anilist.co/img/dir/anime/banner/477.jpg Image url. 1720x390* No
updated_at int 1470913937 Unix timestamp. Last time the series data was modified. Yes
score_distribution array (See score distribution below)   No
list_stats array (See list stats below)   No

* Image size may vary.

Anime model only values

Key Type Example/Possible values Notes In small model
total_episodes int 12 Number of episodes in series season. (0 if unknown) Yes
duration int|null 24 Minutes in the average anime episode. No
airing_status string|null (See anime status types below) Current airing status of the anime. Yes
youtube_id string|null JIKFtTMvNSg Youtube video id No
hashtag string|nulll #shingeki Offical series twitter hashtag No
source string|nulll (See anime source types below) The source adaption media type No
airing_stats array     No

Manga model only values

Key Type Example/Possible values Notes In small model
total_chapters int 24 Number of total chapters in the manga. (0 if unknown) Yes
total_volumes int 2 Number of total volumes in the manga. (0 if unknown) No
publishing_status string|null (See manga status types below) Current publishing status of the manga. Yes

Media types

Id String
0 TV
1 TV Short
2 Movie
3 Special
4 OVA
5 ONA
6 Music
7 Manga
8 Novel
9 One Shot
10 Doujin
11 Manhua
12 Manhwa

Status Types

Anime status string
finished airing
currently airing
not yet aired
cancelled
Manga status string
finished publishing
publishing
not yet published
cancelled

Anime Source Types

Source string
Original
Manga
Light Novel
Visual Novel
Video Game
Other

Fuzzy Dates

8 digit long integer representing YYYYMMDD

20070215 Represents 2007 February 15

Deprecated Dates

ToDo

Genres

ToDo

List Stats

E.g.

"list_stats": {
  "completed": 326,
  "on_hold": 2071,
  "dropped": 2158,
  "plan_to_watch": 446,
  "watching": 5758
}

Score Distribution

0 - 100 distribution object

"score_distribution": {
  "10": 111,
  "20": 65,
  "30": 145,
  "40": 229,
  "50": 421,
  "60": 642,
  "70": 1193,
  "80": 1396,
  "90": 1191,
  "100": 1016
}

Routes

Basic

Url

GET: {series_type}/{id}

Returns a series model.

Page

Url

GET: {series}/{id}/page

Returns a series model with the following:

Up to 9 small model characters (ordered by main role) with Japanese small model actors for anime
Up to 9 small model staff
Up to 2 small model reviews with their users
Relations (small model)
Anime/Manga relations (small model)
Studios (anime)
External links (anime)

Characters / Staff

Url

GET: {series}/{id}/characters
alt: {series}/{id}/staff
alt: {series}/{id}/actors

Returns series model with the following:

Small model characters (ordered by main role) with small model actors
Small model staff

Airing (anime only)

Url

GET: anime/{id}/airing
  • Key: Episode number
  • Value: Airing Time

Browse

Returns up to 40 small series models if paginating.

Browse

Get: browse/{series_type}

Url Parms:
year           : 4 digit year e.g. "2014"
season         : "winter" || "spring" || "summer" || "fall"
type           : (See types table above)
status         : (See status types table above)
genres         : Comma separated genre strings. e.g. "Action,Comedy" Returns series that have ALL the genres.
genres_exclude : Comma separated genre strings. e.g. "Drama" Excludes series that have ANY of the genres.
sort           : "id" || "score" || "popularity" || "start_date" || "end_date" Sorts results, default ascending order. Append "-desc" for descending order e.g. "id-desc"
airing_data    : "true" Includes anime airing data in small models
full_page      : "true" Returns all available results. Ignores pages. Only available when status="Currently Airing" or season is included
page           : int

Genre List

GET: genre_list

List of genres for use with browse queries

The old browse API endpoints will continue to be supported until the next major API version update

Favourite [POST]

Toggle favourite

POST: {series_type}/favourite

Payload

id: (int) series id