UPDATE: i am working on a major revision of the project, stay tuned!
A MyAnimeList API wrapper written in Python.
The objective for now is to cover queries for the publicly available information, support for taking actions on a user list is not planned.
- anime and manga search given a keyword
- fetch details of anime or manga given its id or its url
- accessing public lists of users
- retrieving seasonal anime
- retrieve rankings for anime and manga
- retrieve forum boards and discussions
The next features that are planned to be implemented are:
- retrieve more information on recommendations and related entries
Python 3.8+ is needed.
To use this library:
- (optional) create a virtual environment
python -m venv .venvand activate it - install with
pip install mal-api.py - to perform requests you need an API token log in on MAL -> account settings -> API -> create ID
from mal import client
cli = client.Client('your token here')
anime = cli.get_anime(16498)
anime.title
>> Shingeki_no_KyojinFull documentation available here.
Code samples can be found in the examples folder.
This library uses the logging module to keep track of configuration changes and possible network errors. If you want to see the logs you need to configure the logging module yourself, for example:
import logging
logging.basicConfig(logging.level=INFO)For more information on how to use logging refer to the documentation of python:
This project is still a work in progress, if you have problems or find bugs feel free to open an issue or start a discussion.