Reports

On the reports page you’ll find a list of various dynamically-generated reports. Note the ID in the url to use with the reports.xml endpoint.

The number of rows in any report (either HTML or XML format) can be controlled with the url parameters nskip and nlist. For example you can get the first 50 rows with nskip=0&nlist=50, the next 50 rows with nskip=50&nlist=50, or all rows at once with nlist=all. Some reports accept additional parameters, like this one where type=anime limits the results to anime titles only, and name=Z limits the results to titles starting with the letter Z. See individual reports for details.

If you are building an application which requires a database of anime titles, a typical usage scenario would be to make an initial import with reports.xml?id=155&type=anime&nlist=all and then do a daily import of newly added titles with reports.xml?id=155&type=anime&nlist=50

Anime/Manga Details

If you need more information than the basic details provided in the reports, use this API to fetch detailled information for each title. The basic syntax is api.xml?anime=id. Instead of anime you should use manga if you are fetching a manga’s details, or title if it could be either. For example:

• api.xml?anime=4658 or api.xml?title=4658 to get details of Jinki:Extend (TV)
• api.xml?manga=4199 or api.xml?title=4199 to get details of Jinki:Extend (manga)

Please avoid pre-fetching details for the entire Encyclopedia at once. In a typical usage scenario, you could present to your users a list of all anime titles (imported using the reports above). When a user needs additional info about a certain title your backend would fetch the details for that single title and cache them locally (older titles especially tend not to change so much).

Batching

You can request details for several titles at once by specifying the anime/manga/title parameter more than once, or by using a slash-separated list of ids instead of a single id. You can also get results by name by specifying ~name instead of an id (but this only applies to the main name, not alternative titles). For example these are all equivalent ways to get details for the 3 titles in the Jinki franchise at once:

api.xml?anime=4658&manga=4199&manga=11608
api.xml?anime=4658&manga=4199/11608
api.xml?title=4658/4199/11608
api.xml?title=~jinki 

Please note that you can only batch up to 50 titles at once.