MyAnimeList.net

Rest API Methods

The MyAnimeList.net API revolves around a REST interface. Currently, all REST requests are accepted via HTTP auth.

Search Methods

Anime/Manga Search

Allows authenticating user to search anime/manga titles.

URL:
http://myanimelist.net/api/anime|manga/search.xml?q=full+metal

Formats:
xml

HTTP Method(s):
GET

Requires Authentication:
true

Parameters:

q. Required. URL encoded string of the anime/manga to search for.
- Example: http://myanimelist.net/api/anime/search.xml?q=bleach

Response:
Success: 200 status code, XML data for anime/manga.
Failure: 204 status code (no content).

Example Response:

<?xml version="1.0" encoding="utf-8"?>
<anime>
  <entry>
    <id>2889</id>
    <title>Bleach - The DiamondDust Rebellion</title>
    <english>Bleach: Diamond Dust Rebellion</english>
    <synonyms>Bleach: The Diamond Dust Rebellion - M&Aring; 
    Bleach - The DiamondDust Rebellion - Mou Hitotsu no Hyourinmaru</synonyms>
    <episodes>1</episodes>
    <type>Movie</type>
    <status>Finished Airing</status>
    <start_date>2007-12-22</start_date>
    <end_date>2007-12-22</end_date>
    <synopsis>A valuable artifact known as &amp;quot;King's Seal&amp;quot; is stolen 
    by a mysterious group of people during transport in Soul Society. Hitsugaya Toushiro, 
    the 10th division captain of Gotei 13, who is assigned to transport the seal fights the 
    leader of the group and shortly after goes missing. After the incident, Seireitei declares 
    Hitsugaya a traitor and orders the capture and execution of Hitsugaya. Kurosaki Ichigo 
    refuses to believe this, and along with Matsumoto Rangiku, Kuchiki Rukia and Abarai Renji 
    swear to uncover the real mastermind of the stolen seal, find Hitsugaya and clear his name. 
    Meanwhile, a rogue Hitsugaya searches for the perpetrators and uncovers a 
    dark secret regarding a long dead shinigami. (from ANN)</synopsis>
    <image>http://cdn.myanimelist.net/images/anime/6/4052.jpg</image>
  </entry>
</anime>

Usage Examples:

CURL:
curl -u user:password -d http://myanimelist.net/api/anime/search.xml?q=naruto

Top

Anime List Methods

Add Anime

Allows the authenticating user to add an anime to their anime list.

URL:
http://myanimelist.net/api/animelist/add/id.xml

Formats:
xml

HTTP Method(s):
POST

Requires Authentication:
true

Parameters:

id. Required. The id of the anime to add.

Example: http://myanimelist.net/api/animelist/add/21.xml

data. Required. A parameter specified as 'data' must be passed. It must contain anime values in XML format.

Response:
Will return the unique ID of the row generated by the insert.

Usage Examples:
CURL:
curl -u user:password -d data="XML" http://myanimelist.net/api/animelist/add/21.xml

Update Anime

Allows the authenticating user to update an anime on their anime list.

URL:
http://myanimelist.net/api/animelist/update/id.xml

Formats:
xml

HTTP Method(s):
POST

Requires Authentication:
true

Parameters:

id. Required. The id of the anime to update.

Example: http://myanimelist.net/api/animelist/update/21.xml

data. Required. A parameter specified as 'data' must be passed. It must contain anime values in XML format.

Response:
'Updated' or detailed error message.

Usage Examples:
CURL:
curl -u user:password -d data="XML" http://myanimelist.net/api/animelist/update/21.xml

Delete Anime

Allows the authenticating user to delete an anime from their anime list.

URL:
http://myanimelist.net/api/animelist/delete/id.xml

Formats:
xml

HTTP Method(s):
POST, DELETE

Requires Authentication:
true

Parameters:

id. Required. The id of the anime to delete.

Example: http://myanimelist.net/api/animelist/delete/21.xml

Response:
'Deleted' or detailed error message.

Usage Examples:
CURL:
curl -u user:password -d data="XML" http://myanimelist.net/api/animelist/delete/21.xml

Top

Manga List Methods

Add Manga

Allows the authenticating user to add a manga to their manga list.

URL:
http://myanimelist.net/api/mangalist/add/id.xml

Formats:
xml

HTTP Method(s):
POST

Requires Authentication:
true

Parameters:

id. Required. The id of the manga to add.

Example: http://myanimelist.net/api/mangalist/add/1535.xml

data. Required. A parameter specified as 'data' must be passed. It must contain manga values in XML format.

Response:
Will return the unique ID of the row generated by the insert.

Usage Examples:
CURL:
curl -u user:password -d data="XML" http://myanimelist.net/api/mangalist/add/1535.xml

Update Manga

Works the exact same way as updating anime. But, be sure to use the XML manga values instead.

Delete Manga

Allows the authenticating user to delete a manga from their manga list.

URL:
http://myanimelist.net/api/mangalist/delete/id.xml

Formats:
xml

HTTP Method(s):
POST, DELETE

Requires Authentication:
true

Parameters:

id. Required. The id of the manga to delete.

Example: http://myanimelist.net/api/mangalist/delete/1535.xml

Response:
'Deleted' or detailed error message.

Usage Examples:
CURL:
curl -u user:password -d data="XML" http://myanimelist.net/api/mangalist/delete/1535.xml

Top

Account Methods

Verify Credentials
Allows authenticating user to check username/password.

URL:
http://myanimelist.net/api/account/verify_credentials.xml

Formats:
xml

HTTP Method(s):
GET

Requires Authentication:
true

Response:
Success: 200 status code, XML data for user.
Failure: 204 status code (no content).

Example Response:
<?xml version="1.0" encoding="utf-8"?>
<user>
    <id>1</id>
    <username>Xinil</username>
</user>			
Usage Examples:
CURL:
curl -u user:password http://myanimelist.net/api/account/verify_credentials.xml

Anime Values (XML)

<?xml version="1.0" encoding="UTF-8"?>
<entry>
	<episode>11</episode>
	<status>1</status>
	<score>7</score>
	<downloaded_episodes></downloaded_episodes>
	<storage_type></storage_type>
	<storage_value></storage_value>
	<times_rewatched></times_rewatched>
	<rewatch_value></rewatch_value>
	<date_start></date_start>
	<date_finish></date_finish>
	<priority></priority>
	<enable_discussion></enable_discussion>
	<enable_rewatching></enable_rewatching>
	<comments></comments>
	<fansub_group></fansub_group>
	<tags>test tag, 2nd tag</tags>
</entry>

Parameters:

episode. int
status. int OR string. 1/watching, 2/completed, 3/onhold, 4/dropped, 6/plantowatch
score. int
downloaded_episodes. int
storage_type. int (will be updated to accomodate strings soon)
storage_value. float
times_rewatched. int
rewatch_value. int
date_start. date. mmddyyyy
date_finish. date. mmddyyyy
priority. int
enable_discussion. int. 1=enable, 0=disable
enable_rewatching. int. 1=enable, 0=disable
comments. string
fansub_group. string
tags. string. tags separated by commas

Manga Values (XML)

<?xml version="1.0" encoding="UTF-8"?>
<entry>
	<chapter>6</chapter>
	<volume>1</volume>
	<status>1</status>
	<score>8</score>
	<downloaded_chapters></downloaded_chapters>
	<times_reread></times_reread>
	<reread_value></reread_value>
	<date_start></date_start>
	<date_finish></date_finish>
	<priority></priority>
	<enable_discussion></enable_discussion>
	<enable_rereading></enable_rereading>
	<comments></comments>
	<scan_group></scan_group>
	<tags></tags>
	<retail_volumes></retail_volumes>
</entry>

Parameters:

chapter. int
volume. int
status. int OR string. 1/reading, 2/completed, 3/onhold, 4/dropped, 6/plantoread
score. int
downloaded_chapters. int
times_reread. int
reread_value. int
date_start. date. mmddyyyy
date_finish. date. mmddyyyy
priority. int
enable_discussion. int. 1=enable, 0=disable
enable_rereading. int. 1=enable, 0=disable
comments. string
scan_group. string
tags. string. tags separated by commas
retail_volumes. int

API Documentation

Rest API Methods

Search Methods

Anime List Methods

Manga List Methods

Account Methods

Search Methods

Anime/Manga Search

Anime List Methods

Add Anime

Update Anime

Delete Anime

Manga List Methods

Add Manga

Update Manga

Delete Manga

Account Methods

Verify Credentials

Anime Values (XML)

Manga Values (XML)