Get MyAnimeList season

GET/v1/myanimelist/seasons/{year}/{season}

Headers

x-api-keystringheader

API key (`sfk_...`)

Parameters

yearintegerrequiredpath

Season year, e.g. `2018`. A season with no titles is still `found` with an empty list; only a year with no season data answers `not_found`.

≥ 1917 · ≤ 2100

seasonstringrequiredpath

Season name: `winter`, `spring`, `summer` or `fall`.

one of: winter, spring, summer, fall

Response fields

Endpoint-specific response payload.

datalookupStatus

string

`not_found` when the entity does not exist (a deleted title, an unknown id or user), not when a list is empty.

one of: found, not_found

datayear

integer

Season year.

dataseason

string

Season name: `winter`, `spring`, `summer` or `fall`.

one of: winter, spring, summer, fall

Every title in the season, in listing order.

datatitles[]id

integer

Title id.

datatitles[]mediaKind

string

`anime` or `manga`.

one of: anime, manga

datatitles[]role

stringnullable

Company role on a company card (`Studio`, `Producer`, ...); null on season, genre and stack cards.

datatitles[]title

string

Title.

datatitles[]titleEnglish

stringnullable

English title, when the card includes one. Season and anime genre cards fill it; company and manga genre cards do not.

datatitles[]url

string

Title URL.

datatitles[]imageUrl

stringnullable

Cover image URL.

datatitles[]synopsis

stringnullable

Card synopsis, when the card includes one. Season and anime genre cards fill it; company cards do not.

datatitles[]score

numbernullable

Score, or null.

datatitles[]members

integernullable

Member count.

datatitles[]startDate

stringnullable

Start date as ISO when the day is known, `YYYY-MM` or `YYYY` otherwise. Season and anime genre cards fill it; manga genre cards return null.

datatitles[]mediaType

stringnullable

Format (`TV`, `Movie`, ...), when the card includes it. Season and anime genre cards fill it; company cards do not.

datatitles[]status

stringnullable

Airing or publishing status, when the card includes it. Season and anime genre cards fill it; company cards do not.

datatitles[]episodes

integernullable

Episode count, when the card includes it. Season and anime genre cards fill it; company and manga genre cards do not.

datatitles[]duration

stringnullable

Duration text, when the card includes it. Season and anime genre cards fill it; company cards do not.

datatitles[]source

stringnullable

Source material, when the card includes it. Season and anime genre cards fill it; company cards do not.

Genres.

datatitles[]genres[]id

integernullable

MyAnimeList id, when linked.

datatitles[]genres[]name

string

Name.

datatitles[]genres[]url

stringnullable

Entity URL, when linked.

datatitles[]genres[]role

stringnullable

Role, when one is listed (manga authors).

Themes.

datatitles[]themes[]id

integernullable

MyAnimeList id, when linked.

datatitles[]themes[]name

string

Name.

datatitles[]themes[]url

stringnullable

Entity URL, when linked.

datatitles[]themes[]role

stringnullable

Role, when one is listed (manga authors).

Demographics.

datatitles[]demographics[]id

integernullable

MyAnimeList id, when linked.

datatitles[]demographics[]name

string

Name.

datatitles[]demographics[]url

stringnullable

Entity URL, when linked.

datatitles[]demographics[]role

stringnullable

Role, when one is listed (manga authors).

Studios.

datatitles[]studios[]id

integernullable

MyAnimeList id, when linked.

datatitles[]studios[]name

string

Name.

datatitles[]studios[]url

stringnullable

Entity URL, when linked.

datatitles[]studios[]role

stringnullable

Role, when one is listed (manga authors).

Manga authors.

datatitles[]authors[]id

integernullable

MyAnimeList id, when linked.

datatitles[]authors[]name

string

Name.

datatitles[]authors[]url

stringnullable

Entity URL, when linked.

datatitles[]authors[]role

stringnullable

Role, when one is listed (manga authors).

datatitles[]hasVideo

boolean

Whether the card links to a promotional or episode video.

Metadata describing the request and billing outcome.

metarequestId

string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged

integer

Credits charged for this request.

≥ 0

metaversion

string

Public API version that served the response.

one of: v1

Headers

Code example

Responses