/kuristina

An API that lets you fetch user lists from MyAnimeList.

Primary LanguageJavaScriptMIT LicenseMIT

Kuristina

IMPORTANT: Kuristina has been deprecated since the MAL API blackout in May 2018 took down one of the critical MAL endpoints. Please use Jikan or a similar project.

Kuristina is here to assist you in fetching list contents for both manga and anime lists from MyAnimeList. This page contains all of the documentation you need to use it, but if you want to find out more about how it was developed refer to this article.

Features

At the moment, Kuristina only has 2 features:

  • Fetching anime list by username, printing the result in either XML or JSON.
  • Fetching manga list by username, printing the result in either XML or JSON.

This list is most likely to expand over time, so you might wanna check this page once in a while if you're interested.

Note: Kuristina now has a Node.js wrapper.

Usage

At the moment Kuristina only accepts GET request of the following format:

https://kuristina.herokuapp.com/<LIST-TYPE>/<USERNAME>.<FORMAT>

Where <LIST-TYPE> is either anime or manga to fetch anime or manga list respectively, <USERNAME> is the name of the user whose list you want to fetch and finally <FORMAT> is the format in which the list will be returned, either xml or json. All of the 3 parameters are case-insensitive. Consider the examples below

# Fetch Timbo_KZ's manga list in XML
GET https://kuristina.herokuapp.com/manga/Timbo_KZ.xml

# Fetch Timbo_KZ's anime list in JSON
GET https://kuristina.herokuapp.com/anime/Timbo_KZ.json

Possible errors

Here are several possible cases which might have to handle in your applcaition:

  • If you access any other URL but the index or the URLs of format specified above, Kuristina will return 404 Not Found status code.
  • If the list type is not supported, username does not appear to be valid (i.e. MAL user names can only contain letters, numbers, dashes and underscores) or format specified is not supported Kuristina will return 400 Bad Request status code.
  • If you request a list and the username does not exist (i.e. MAL cannot find it), 404 Not Found status code will be returned.
  • If any other error occurs during fetching, server will return 500 Internal Server Error status code.

Example responses

Anime list in XML:

<myanimelist>
    <myinfo>
        <user_id>4718042</user_id>
        <user_name>Timbo_KZ</user_name>
        <user_watching>57</user_watching>
        <user_completed>125</user_completed>
        <user_onhold>1</user_onhold>
        <user_dropped>1</user_dropped>
        <user_plantowatch>31</user_plantowatch>
        <user_days_spent_watching>43.86</user_days_spent_watching>
    </myinfo>
    <anime>
        <series_animedb_id>1</series_animedb_id>
        <series_title>Cowboy Bebop</series_title>
        <series_synonyms>COWBOY BEBOP; Cowboy Bebop</series_synonyms>
        <series_type>1</series_type>
        <series_episodes>26</series_episodes>
        <series_status>2</series_status>
        <series_start>1998-04-03</series_start>
        <series_end>1999-04-24</series_end>
        <series_image>
        https://myanimelist.cdn-dena.com/images/anime/4/19644.jpg
        </series_image>
        <my_id>0</my_id>
        <my_watched_episodes>26</my_watched_episodes>
        <my_start_date>2016-02-15</my_start_date>
        <my_finish_date>2016-04-02</my_finish_date>
        <my_score>8</my_score>
        <my_status>2</my_status>
        <my_rewatching>0</my_rewatching>
        <my_rewatching_ep>0</my_rewatching_ep>
        <my_last_updated>1459548352</my_last_updated>
        <my_tags/>
    </anime>
</myanimelist>

Anime list in JSON:

{  
   "myanimelist":{  
      "myinfo":{  
         "user_id":"4718042",
         "user_name":"Timbo_KZ",
         "user_watching":"57",
         "user_completed":"125",
         "user_onhold":"1",
         "user_dropped":"1",
         "user_plantowatch":"31",
         "user_days_spent_watching":"43.86"
      },
      "anime":[  
         {  
            "series_animedb_id":"1",
            "series_title":"Cowboy Bebop",
            "series_synonyms":"COWBOY BEBOP; Cowboy Bebop",
            "series_type":"1",
            "series_episodes":"26",
            "series_status":"2",
            "series_start":"1998-04-03",
            "series_end":"1999-04-24",
            "series_image":"https://myanimelist.cdn-dena.com/images/anime/4/19644.jpg",
            "my_id":"0",
            "my_watched_episodes":"26",
            "my_start_date":"2016-02-15",
            "my_finish_date":"2016-04-02",
            "my_score":"8",
            "my_status":"2",
            "my_rewatching":"0",
            "my_rewatching_ep":"0",
            "my_last_updated":"1459548352",
            "my_tags":null
         }
      ]
   }
}

Manga list in XML:

<myanimelist>
    <myinfo>
        <user_id>4718042</user_id>
        <user_name>Timbo_KZ</user_name>
        <user_reading>6</user_reading>
        <user_completed>0</user_completed>
        <user_onhold>0</user_onhold>
        <user_dropped>0</user_dropped>
        <user_plantoread>0</user_plantoread>
        <user_days_spent_watching>0.99</user_days_spent_watching>
    </myinfo>
    <manga>
        <series_mangadb_id>7776</series_mangadb_id>
        <series_title>Toaru Kagaku no Railgun</series_title>
        <series_synonyms>
        To Aru Kagaku no Choudenjihou; A Certain Scientific Railgun
        </series_synonyms>
        <series_type>1</series_type>
        <series_chapters>0</series_chapters>
        <series_volumes>0</series_volumes>
        <series_status>1</series_status>
        <series_start>2007-05-27</series_start>
        <series_end>0000-00-00</series_end>
        <series_image>
        https://myanimelist.cdn-dena.com/images/manga/1/149212.jpg
        </series_image>
        <my_id>45546470</my_id>
        <my_read_chapters>79</my_read_chapters>
        <my_read_volumes>0</my_read_volumes>
        <my_start_date>2015-09-14</my_start_date>
        <my_finish_date>0000-00-00</my_finish_date>
        <my_score>10</my_score>
        <my_status>1</my_status>
        <my_rereadingg/>
        <my_rereading_chap>0</my_rereading_chap>
        <my_last_updated>1444721961</my_last_updated>
        <my_tags/>
    </manga>
</myanimelist>

Manga list in JSON:

{  
   "myanimelist":{  
      "myinfo":{  
         "user_id":"4718042",
         "user_name":"Timbo_KZ",
         "user_reading":"6",
         "user_completed":"0",
         "user_onhold":"0",
         "user_dropped":"0",
         "user_plantoread":"0",
         "user_days_spent_watching":"0.99"
      },
      "manga":[  
         {  
            "series_mangadb_id":"7776",
            "series_title":"Toaru Kagaku no Railgun",
            "series_synonyms":"To Aru Kagaku no Choudenjihou; A Certain Scientific Railgun",
            "series_type":"1",
            "series_chapters":"0",
            "series_volumes":"0",
            "series_status":"1",
            "series_start":"2007-05-27",
            "series_end":"0000-00-00",
            "series_image":"https://myanimelist.cdn-dena.com/images/manga/1/149212.jpg",
            "my_id":"45546470",
            "my_read_chapters":"79",
            "my_read_volumes":"0",
            "my_start_date":"2015-09-14",
            "my_finish_date":"0000-00-00",
            "my_score":"10",
            "my_status":"1",
            "my_rereadingg":null,
            "my_rereading_chap":"0",
            "my_last_updated":"1444721961",
            "my_tags":null
         }
      ]
   }
}