API Documentation | AnimeSchedule.net

Base URL: https://animeschedule.net/api/v3

OBJ

List Anime

route

string

The unique URL slug of the anime.

listStatus

string

The list the anime belongs to.

Examples:

completed

watching

on-hold

dropped

to-watch

episodesSeen

int

The amount of episodes seen from the anime.

episodes

int

Max episode count for the anime.

manualScore

int

The user's manually inputted score of the anime. From 0 to a 100.

Examples:

averageAutoScore

int

The user's automatically calculated average score of the anime. From 0 to a 100.

Examples:

useAutoScores

bool

Whether to use automatic score calculation with multiple scores.

autoScores

startDate

datetime

The date the anime was started watching.

endDate

datetime

The date the anime was finished watching.

hasAiredJpn

bool

Whether the latest raw episode has aired.

Examples:

true

false

hasAiredSub

bool

Whether the latest sub episode has aired.

Examples:

true

false

hasAiredDub

bool

Whether the latest dub episode has aired.

Examples:

true

false

leadingTrack

string

Which release track has the earliest premier among raw, sub, and dub. latestEpisode, subtractedEpisode, and latestEpisodeDate refer to this track.

Examples:

raw

sub

dub

latestEpisode

int

Latest episode number for leadingTrack.

Examples:

subtractedEpisode

int

Subtracted episode count for leadingTrack.

Examples:

latestEpisodeDate

datetime

Air datetime for the latest episode of leadingTrack (RFC 3339). Omitted when unknown.

Examples:

2025-04-10T15:30:00Z

showID

string

Internal show identifier.

Examples:

a1b2c3d4

preferredTitle

string

Display title for the request language query.

Examples:

BLACK LAGOON

Sousou no Frieren

status

string

Show status.

Examples:

Ongoing

Finished

Upcoming

Delayed

Break

year

int

Show year.

Examples:

2024

2025

season

string

Season title string from the show record.

Examples:

Winter 2025

Spring 2024

genres

string

Concatenated genre names.

Examples:

ActionAdventure

ComedyDrama

studios

string

Concatenated studio names.

Examples:

MAPPAMadhouse

sources

string

Concatenated source names.

Examples:

MangaLight novel

mediaTypes

string

Concatenated media type names.

Examples:

Movie

releaseDate

string

Lead premier (earliest among tracks).

Examples:

02 Jan 2006

note

string

User note. Max length is 1000.

Examples:

I really liked this anime because...

imageVersionRoute

string

Versioned poster path for cache busting (from site image manifests).

Examples:

anime/jpg/default/my-show-route-abc123def

posterDominantColor

string

Poster dominant color as RGB triplet values.

Examples:

12,34,56

OBJ

List Anime PUT

listStatus

string

The list the anime belongs to.

Examples:

completed

watching

on-hold

dropped

to-watch

episodesSeen

int

The amount of episodes seen from the anime.

manualScore

int

The user's manually inputted score of the anime. From 0 to a 100.

Examples:

useAutoScores

bool

Whether to use automatic score calculation with multiple scores.

autoScores

AutoScores

startDate

datetime

The date the anime was started watching.

endDate

datetime

The date the anime was finished watching.

note

string

User note. Max length is 1000.

Examples:

I really liked this anime because...

action

string

Indicates a non-standard operation. Used only in PUT requests. Valid values are deleteNote.

Examples:

deleteNote

OBJ

AutoScore

OBJ

AutoScores

OBJ

Custom List

GET

/animelists/{user}/{route} /animelists/oauth/{route}

Fetch a user's specific List Anime

GET

/animelists/{user} /animelists/oauth

Fetch all the List Animes of a user

Description

Returns the user's ID, username, a map of List Anime and an array of Custom List. Supports optional server-side sort/filter/pagination query parameters.

Examples:

/animelists/animeLover52

/animelists

offset

query

0-based offset for paginated results.

Examples:

100

limit

query

Page size. Defaults to 100, max 200.

Examples:

100

200

sort

query

Sort key.

Examples:

alphabetical

episodes-seen

score

started-date

finished-date

release-date

weekday

reverse

query

When set to 1, true, or yes, reverses the sort order before pagination.

Examples:

true

list

query

List route/status filter.

Examples:

watching

completed

my-custom-list

title

query

Case-insensitive title filter.

genre

query

Case-insensitive genre filter.

studio

query

Case-insensitive studio filter.

source

query

Case-insensitive source filter.

mediaType

query

Case-insensitive media type filter.

year

query

Year filter.

Examples:

2024

season

query

Season filter.

Examples:

winter

spring

language

query

Title language used for title filtering and alphabetical sorting.

Examples:

romaji

english

japanese

weekType

query

First day-of-week when sorting by weekday.

Examples:

monday

sunday

PUT

OAuth2

/animelists/oauth /animelists/{user}

Import an anime list from MyAnimeList via .xml file

PUT

OAuth2

/animelists/oauth/{route} /animelists/{user}/{route}

Add/Update a specific List Anime for a user

Description

Route is the anime's URL slug. Use List Anime values as a reference for adding/updating. Omitted values will stay as they were.

Examples:

/animelists/one-piece

/animelists/animeLover52/naruto

Etag

header

An Etag header in the request headers. Mandatory and must be valid. You can get a valid Etag by doing a GET request on a specific List Anime beforehand and getting it from the response headers.

List Anime PUT

Examples:

{ "listStatus": "on-hold", "episodesSeen": 100, "manualScore": 50, "startDate": "2015-10-20T00:00:00Z", "endDate": "0001-01-01T00:00:00Z", "note": "This is an example note." }

{ "listStatus": "watching", "episodesSeen": 523, "manualScore": 0, "useAutoScores": true, "autoScores": { "scoreOne": { "scoreText": "Story", "score": 10 }, "scoreTwo": { "scoreText": "Visuals", "score": 7 }, "scoreThree": { "scoreText": "Sound", "score": 7 }, "scoreFour": { "scoreText": "Enjoyment", "score": 10 } }, "note": "This is a second example note." }

{ "episodesSeen": 1000 }

{ "action": "deleteNote" }

DELETE

OAuth2

/animelists/oauth/{route} /animelists/{user}/{route}

Delete a user's specific List Anime

DELETE

OAuth2

/animelists/oauth /animelists/{user}

Delete a user's entire anime list