Hato

Anime/Manga Title ID Relations JSON API written in C# (ASP.NET Core)

View the Project on GitHub Atelier-Shiori/Hato

Hato is a REST API built on ASP.NET Core and written in C#. It allows developers to easily look up title identifiers for a certain title on different listing services to increase interoperability for things like exporting lists, list syncing and updating entries on different services of the same title. The mappings are stored in a database so that title id mappings can be retrieved without a lookup.

Supported Services

Currently, Hato supports conversion of title ids of the following:

Reporting Mapping Errors?

While this doesn't usually happens, there is a small chance that the mappings point to the wrong title ids. If you encounter this, report it here. Please do not file issues for mapping mistakes.

Support us

Currently, this is a free service for testing by using the form above. For use in applications, you must be an active patron to request access. You can support this project and others (Hachidori and Shukofukurou) by becoming a Patreon. Once you become a patron, you can request access to this production instance.

Become a Patron!

Try it Out

How to Use

Endpoints

GET https://hato.malupdaterosx.moe/api/mappings/(service)/(media type)/(id)
		

Retreives a single title id mapping.

Parameters

Parameter Value Required
service mal or kitsu or anilist (Anime Only: anidb or notify) true
media type MediaType (anime or manga) true
id number true

Example

[GET] http://hato.malupdaterosx.moe/api/mappings/kitsu/anime/11134
		

Response


    {"data":{"anilist_id":21238,"kitsu_id":11134,"mal_id":31080,"type":0,"type_str":"anime"}}

    POST https://hato.malupdaterosx.moe/api/mappings/mappings

Parameters

Parameter Value Required
body (JSON body input. See example for format)

    {
    "media_type" : "anime",
    "service" : "mal",
    "title_ids" : [1, 31080, 37786]
    }
true

Example


    [POST] http://hato.malupdaterosx.moe/api/mappings/mappings

Retreives multiple title id mappings (10 max).

Request Body


    {
    "media_type" : "anime",
    "service" : "mal",
    "title_ids" : [1, 31080, 37786, 25835, 21681, 24705, 22147, 20509, 10928, 19815]
    }

Response


    {
    "data": [
    {
    "anidb_id": 23,
    "anilist_id": 1,
    "kitsu_id": 1,
    "mal_id": 1,
    "notify_id": "Tk3ccKimg",
    "type": 0,
    "type_str": "anime"
    },
    {
    "anidb_id": 11321,
    "anilist_id": 21238,
    "kitsu_id": 11134,
    "mal_id": 31080,
    "notify_id": "090XtKimg",
    "type": 0,
    "type_str": "anime"
    },
    {
    "anidb_id": null,
    "anilist_id": 101573,
    "kitsu_id": 41240,
    "mal_id": 37786,
    "notify_id": "ytl6tj7mg",
    "type": 0,
    "type_str": "anime"
    },
    {
    "anidb_id": 10779,
    "anilist_id": 20812,
    "kitsu_id": 8698,
    "mal_id": 25835,
    "notify_id": "jlx1pFmiR",
    "type": 0,
    "type_str": "anime"
    },
    {
    "anidb_id": 10351,
    "anilist_id": 20575,
    "kitsu_id": 8138,
    "mal_id": 21681,
    "notify_id": "ylgTtFmmg",
    "type": 0,
    "type_str": "anime"
    },
    {
    "anidb_id": 10323,
    "anilist_id": 20565,
    "kitsu_id": 8710,
    "mal_id": 24705,
    "notify_id": "2SLJtFiiR",
    "type": 0,
    "type_str": "anime"
    },
    {
    "anidb_id": 10399,
    "anilist_id": 20602,
    "kitsu_id": 8259,
    "mal_id": 22147,
    "notify_id": "ua1opKmmR",
    "type": 0,
    "type_str": "anime"
    },
    {
    "anidb_id": 10091,
    "anilist_id": 20467,
    "kitsu_id": 8003,
    "mal_id": 20509,
    "notify_id": "sThhpFiiR",
    "type": 0,
    "type_str": "anime"
    },
    {
    "anidb_id": 9155,
    "anilist_id": 10928,
    "kitsu_id": 6410,
    "mal_id": 10928,
    "notify_id": "qqgStKmiR",
    "type": 0,
    "type_str": "anime"
    },
    {
    "anidb_id": 9998,
    "anilist_id": 19815,
    "kitsu_id": 7880,
    "mal_id": 19815,
    "notify_id": "cErppFmiR",
    "type": 0,
    "type_str": "anime"
    }
    ],
    "failed_list": []
    }

License

Hato is licensed under Apache License 2.0