https://github.com/deepghs/pyanimeinfo
Python anime information grabber
https://github.com/deepghs/pyanimeinfo
Last synced: 2 months ago
JSON representation
Python anime information grabber
- Host: GitHub
- URL: https://github.com/deepghs/pyanimeinfo
- Owner: deepghs
- License: apache-2.0
- Created: 2023-10-28T05:40:21.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-22T04:28:32.000Z (almost 2 years ago)
- Last Synced: 2025-12-15T20:14:09.758Z (6 months ago)
- Language: Python
- Homepage: https://deepghs.github.io/pyanimeinfo/
- Size: 9.55 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pyanimeinfo
[](https://pypi.org/project/pyanimeinfo/)
[](https://github.com/deepghs/pyanimeinfo/actions?query=workflow%3A%22Code+Test%22)
[](https://github.com/deepghs/pyanimeinfo/actions?query=workflow%3A%22Package+Release%22)
[](https://codecov.io/gh/deepghs/pyanimeinfo)
[](https://github.com/deepghs/pyanimeinfo/stargazers)
[](https://github.com/deepghs/pyanimeinfo/network)
[](https://github.com/deepghs/pyanimeinfo/issues)
[](https://github.com/deepghs/pyanimeinfo/pulls)
[](https://github.com/deepghs/pyanimeinfo/graphs/contributors)
[](https://github.com/deepghs/pyanimeinfo/blob/master/LICENSE)
Python anime information grabber
## Installation
You can simply install it with `pip` command line from the official PyPI site.
```shell
pip install pyanimeinfo
```
For more information about installation, you can refer
to [Installation](https://deepghs.github.io/pyanimeinfo/main/tutorials/installation/index.html).
## Quick Start
### Accessing Information from Bangumi.tv
We can retrieve information from [Bangumi.tv](https://bangumi.tv/).
```python
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](https://myanimelist.net/). However, since the original MyAnimeList site
does not provide a useful API, we utilize the unofficial API [Jikan V4](https://jikan.moe/) to retrieve data from
MyAnimeList.
```python
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.