MyAnimeList.net

API Documentation

Rest API Methods

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

Search Methods

Anime List Methods

Manga List Methods

Account Methods

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
Help     FAQ     About     Contact     Terms     Privacy     AdChoices