Skip to content

deepghs/pyanimeinfo

Repository files navigation

pyanimeinfo

PyPI PyPI - Python Version Loc Comments

Code Test Package Release codecov

GitHub Org's stars GitHub stars GitHub forks GitHub commit activity GitHub issues GitHub pulls Contributors GitHub license

Python anime information grabber

Installation

You can simply install it with pip command line from the official PyPI site.

pip install pyanimeinfo

For more information about installation, you can refer to Installation.

Quick Start

Accessing Information from Bangumi.tv

We can retrieve information from Bangumi.tv.

from pyanimeinfo.bangumitv import BangumiTVClient

client = BangumiTVClient()

# search subject from bangumi.tv
client.search_subjects('Railgun')

# query specific subject from bangumi.tv
# e.g. Railgun
client.get_subject(2585)

# list characters in this subjects
client.get_subject_characters(2585)

# query specific character
client.get_character(3575)

# list character related persons
# e.g. CV, artists
client.get_character_related_persons(3575)

# list character related subjects
# e.g. Railgun series
client.get_character_related_subjects(3575)

# get person
client.get_person(4670)

Accessing Information from MyAnimeList.net

We can access information from MyAnimeList. However, since the original MyAnimeList site does not provide a useful API, we utilize the unofficial API Jikan V4 to retrieve data from MyAnimeList.

from pyanimeinfo.myanimelist import JikanV4Client

client = JikanV4Client()

# search animes
client.search_anime('Railgun')

# get specific anime
client.get_anime(6213)

# get full information of specific anime
client.get_anime_full(6213)

# get characters in specific anime
client.get_anime_characters(6213)

# search characters
client.search_anime('misaka mikoto')

# get specific character
client.get_character(13701)

# get full information of specific character
client.get_character_full(13701)

# get character related information
client.get_character_related_animes(13701)
client.get_character_related_manga(13701)
client.get_character_voice_actors(13701)
client.get_character_pictures(13701)

Important Notes

  1. The pyanimeinfo library is primarily designed for querying anime-related information and is not a comprehensive client for bangumi.tv or any other website. Therefore, we currently do not plan to provide support for operations like user authentication and user sessions in the short term. Your understanding is appreciated.

  2. The reason this library is not named pybangumitv is that our intention is not limited to integrating only the bangumi.tv website. In the future, we aim to introduce support for additional websites, including MyAnimeList, Fandom, and others. Stay tuned for updates.