DOCUMENTATION.md

MyAnimeList Private API Documentation

All responses return JSON

> All POST requests are type application/x-www-form-urlencoded

Client ID

Some endpoints are protected with a client ID. This ID is stored in plaintext in the official MAL app, and seems to be a static value. The client ID is 6114d00ca681b7701d1e15fe11a4987e

Data Fields

Some endpoints take a fields parameter which is a set of fields used to determine what data is to be returned about the query

Name	Description
alternative_titles	Titles in other languages and formats
media_type	Movie or TV show
num_episodes	Number of total episodes (including unaired)
status	Airing status
start_date	Airing start date
end_date	Airing end date
average_episode_duration	Average episode length in seconds
synopsis	Media synopsis
mean	User rating score
rank	MAL ranking
popularity	MAL popularity? (need clarification on how this differs from ranking)
num_list_users	Number of users who have this media in a list
num_favorites	Number of favorites
num_scoring_users	Number of users who have scored this media
start_season	Object containing the year and airing season
broadcast	Object containing the day and time of new episodes
nsfw	String containing colors? (to determine how "NSFW" the media is?)
created_at	When was this media created in the API/database
updated_at	When was this media updated in the API/database

Endpoints

BaseURL

Base URL for the API is https://api.myanimelist.net/v0.8 (at least in the version of the app I reversed)

The oAuth refresh token endpoint /oauth2/token is the only endpoint which uses a different base, being https://myanimelist.net/v1

[POST] /auth/token

Logs in a user with a username and password. Returns an oAuth authorization and refresh token

Body

Parameter	Value
client_id	App client ID
username	Account username
password	Account password
grant_type	password

[POST] /oauth2/token

Refreshes a login session with an oAuth refresh token. Returns an oAuth authorization and refresh token

Body

Parameter	Value
client_id	App client ID
refresh_token	oAuth refresh token
grant_type	refresh_token

[GET] /anime/search

Runs a search on the database based on the status parameter. Contrary to what the endpoint suggests this does NOT run a query search

Query Parameters

Name	Description	Optional
q	query string (is ignored by API)	True
status	Anime airing status to search by (only currently_airing and not_yet_aired are accepted)	False
limit	Return count upper limit	True
offset	Result offset based on limit	True
fields	Data fields	True

[GET] /anime

Runs a search on the database based on the q parameter

Query Parameters

Name	Description	Optional
q	query string (is ignored by API)	False
limit	Return count upper limit	True
offset	Result offset based on limit	True
fields	Data fields	True

[GET] /anime/{id}

Gets anime details

Query Parameters

Name	Description	Optional
fields	Data fields	True

[GET] /anime/ranking

Gets top anime by rank and ranking type

Query Parameters

Name	Description	Optional
ranking_type	Sort type (trend or bypopularity)	True
limit	Return count upper limit	True
offset	Result offset based on limit	True
fields	Data fields	True

[GET] /anime/season/{year}/{season}

Gets anime releasing/released in a given season

Query Parameters

Name	Description	Optional
sort	Sort type (anime_num_list_users or anime_score)	True
limit	Return count upper limit	True
offset	Result offset based on limit	True
fields	Data fields	True

[GET] /anime/suggestions

Gets anime suggestions for logged in user. Requires login

Query Parameters

Name	Description	Optional
limit	Return count upper limit	True
offset	Result offset based on limit	True
fields	Data fields	True

[PUT] /anime/{id}/my_list_status

Adds an anime to your list or updates an existing entry. Requires login

Body

Parameter	Value
status	Watching status (plan_to_watch, completed, watching, on_hold, dropped)
score	User score (0 is no score, 1 is lowest score, 10 is highest score)
num_watched_episodes	Number of total episodes watched
is_rewatching	Bool (seems to not be returned by API?)
start_date	Date started (seems to not be returned by API?)
finish_date	Date completed (seems to not be returned by API?)

[DELETE] /anime/{id}/my_list_status

Removes an anime from your list. Requires login

[GET] /users/@me

Gets user profile data. Requires login

Query Parameters

Name	Description	Optional
fields	Data fields	True

[GET] /users/@me/animelist

Gets user anime list. Requires login

Query Parameters

Name	Description	Optional
status	Watching status (plan_to_watch, completed, watching, on_hold, dropped)	True
sort	Sort type (list_score, anime_start_date, anime_title, list_updated_at)	True
limit	Return count upper limit	True
offset	Result offset based on limit	True
fields	Data fields	True

[POST] /users/@me/device_tokens

Returns a list of device tokens? (Always returns an empty array). Requires login

Body

Parameter	Value
device_token	Firebase token?
device_type	Device type string (android)