Requirements

• Python 3.7 or higher

• aiohttp (for async support)

• dacite

• requests

• typing_extensions (for Python <= 3.8)

Custom Headers

You can pass custom headers to the API client, which is useful for APIs that require authorization (e.g., ids.moe):

import animeapi

# Using custom headers for ids.moe
headers = {"Authorization": "Bearer YOUR_TOKEN_HERE"}

with animeapi.AnimeAPI(base_url="https://ids.moe", headers=headers) as api:
    # Get anime relation data with custom headers
    mal = api.get_anime_relations(1, animeapi.Platform.MYANIMELIST)
    print(mal)

Asyncronous Usage

Similarly, for async, you just need to replace AnimeAPI with AsyncAnimeAPI and use await on the methods.

You must use the wrapper in with statement, or you will receive RuntimeError exception.

import asyncio
import animeapi

async def main():
    async with animeapi.AsyncAnimeAPI() as api:
        # Get anime relation data for the anime with ID 1 on MyAnimeList
        mal = await api.get_anime_relations(1, animeapi.Platform.MYANIMELIST)
        print(mal)

        # Get list of anime available on AniList
        anilist = await api.get_list_anime_relations(animeapi.Platform.ANILIST)
        print(anilist[:2])  # Print first two results

        # Get dictionary of anime available on Kitsu
        kitsu = await api.get_dict_anime_relations(animeapi.Platform.KITSU)
        print(kitsu['1'])  # Print data for Cowboy Bebop

if __name__ == "__main__":
    asyncio.run(main())

Custom headers can also be used with async:

import asyncio
import animeapi

async def main():
    headers = {"Authorization": "Bearer YOUR_TOKEN_HERE"}

    async with animeapi.AsyncAnimeAPI(base_url="https://ids.moe", headers=headers) as api:
        mal = await api.get_anime_relations(1, animeapi.Platform.MYANIMELIST)
        print(mal)

if __name__ == "__main__":
    asyncio.run(main())

Available Methods

# Get anime relation data for the anime with ID 1 on MyAnimeList
mal = api.get_anime_relations(1, animeapi.Platform.MYANIMELIST)
print(mal)

# Get anime relation data for Trakt shows with season
trakt = api.get_anime_relations(152334, animeapi.Platform.TRAKT,
                                 media_type=animeapi.TraktMediaType.SHOWS,
                                 title_season=3)
print(trakt)

# Get anime relation data for TMDB TV shows
tmdb = api.get_anime_relations(12345, animeapi.Platform.THEMOVIEDB,
                                media_type=animeapi.TmdbMediaType.TV)
print(tmdb)

# Get anime relation data for The TVDB with season
tvdb = api.get_anime_relations(76885, animeapi.Platform.THETVDB,
                                title_season=1)
print(tvdb)

# Get dictionary of anime available on Kitsu
kitsu = api.get_dict_anime_relations(animeapi.Platform.KITSU)
print(kitsu['1'])  # Print data for Cowboy Bebop

# Get list of anime available on AniList
anilist = api.get_list_anime_relations(animeapi.Platform.ANILIST)
print(anilist[:2])  # Print first two results

# Get list of anime available on AnimeAPI
animeapi_list = api.get_list_index()
print(animeapi_list[:2])  # Print first two results

# Get status of AnimeAPI
status = api.get_status()
print(status)

# Get heartbeat of AnimeAPI
heartbeat = api.get_heartbeat()
print(heartbeat)

# Get last updated time of AnimeAPI
updated = api.get_updated_time()
print(updated)
print(updated.datetime())  # Convert to datetime class