Anime List

The sections below will show you how to get the anime list using different methods.

get_anime_list()

Basic example

 1from myanimelistpy.myanimelist import MyAnimeList
 2
 3CLIENT_ID = "YOUR_MY_ANIME_LIST_CLIENT_ID"
 4
 5if __name__ == "__main__":
 6    my_anime_list = MyAnimeList(client_id=CLIENT_ID)
 7
 8    anime_list = my_anime_list.get_anime_list(
 9        anime_name = "Hunter x Hunter",
10        limit      = 2
11    )
12
13    for anime in anime_list:
14        print(f"Id: {anime.get_id()}")
15        print(f"Title: {anime.get_title()}")
16        print(f"Main Picture (medium): {anime.get_main_picture().get_medium()}\n")

Output

Id: 11061
Title: Hunter x Hunter (2011)
Main Picture (medium): https://api-cdn.myanimelist.net/images/anime/1337/99013.jpg

Id: 136
Title: Hunter x Hunter
Main Picture (medium): https://api-cdn.myanimelist.net/images/anime/8/19473.jpg

Request with fields

 1from myanimelistpy.myanimelist import MyAnimeList
 2
 3CLIENT_ID = "YOUR_MY_ANIME_LIST_CLIENT_ID"
 4
 5if __name__ == "__main__":
 6    my_anime_list = MyAnimeList(client_id=CLIENT_ID)
 7
 8    anime_list = my_anime_list.get_anime_list(
 9        anime_name = "Hunter x Hunter",
10        limit      = 2,
11        fields     = ["rank", "status"]
12    )
13
14    for anime in anime_list:
15        print(f"Id: {anime.get_id()}")
16        print(f"Title: {anime.get_title()}")
17        print(f"Main Picture (medium): {anime.get_main_picture().get_medium()}")
18        print(f"Rank: {anime.get_rank()}")
19        print(f"Status: {anime.get_status()}\n")

Output

Id: 11061
Title: Hunter x Hunter (2011)
Main Picture (medium): https://api-cdn.myanimelist.net/images/anime/1337/99013.jpg
Rank: 9
Status: Finished airing

Id: 136
Title: Hunter x Hunter
Main Picture (medium): https://api-cdn.myanimelist.net/images/anime/8/19473.jpg
Rank: 165
Status: Finished airing

Tip

We strongly recommend using a .env file or something similar to store your Client ID. You can use the python-dotenv library to do this. Click here to check out their documentation.

 1from os import getenv
 2from dotenv import load_dotenv
 3
 4from myanimelistpy.myanimelist import MyAnimeList
 5
 6load_dotenv()
 7
 8CLIENT_ID = getenv("CLIENT_ID")
 9
10if __name__ == "__main__":
11    my_anime_list = MyAnimeList(client_id=CLIENT_ID)
12
13    anime_list = my_anime_list.get_anime_list(
14        anime_name = "Hunter x Hunter",
15        limit      = 2,
16        fields     = ["rank", "status"]
17    )
18
19    for anime in anime_list:
20        print(f"Id: {anime.get_id()}")
21        print(f"Title: {anime.get_title()}")
22        print(f"Main Picture (medium): {anime.get_main_picture().get_medium()}")
23        print(f"Rank: {anime.get_rank()}")
24        print(f"Status: {anime.get_status()}\n")

All the next examples will using the python-dotenv library, but feel free not to use it if you don’t want to.

get_anime_list_in_dict()

 1from os import getenv
 2from dotenv import load_dotenv
 3
 4from myanimelistpy.myanimelist import MyAnimeList
 5
 6load_dotenv()
 7
 8CLIENT_ID = getenv("CLIENT_ID")
 9
10if __name__ == "__main__":
11    my_anime_list = MyAnimeList(client_id=CLIENT_ID)
12
13    anime_list = my_anime_list.get_anime_list_in_dict(
14        anime_name = "Hunter x Hunter",
15        limit      = 2,
16        fields     = ["genres"]
17    )
18
19    for anime in anime_list:
20        print(str(anime) + "\n")

Output

{'node': {'id': 11061, 'title': 'Hunter x Hunter (2011)', 'main_picture': {'medium': 'https://api-cdn.myanimelist.net/images/anime/1337/99013.jpg', 'large': 'https://api-cdn.myanimelist.net/images/anime/1337/99013l.jpg'}, 'genres': [{'id': 1, 'name': 'Action'}, {'id': 2, 'name': 'Adventure'}, {'id': 10, 'name': 'Fantasy'}, {'id': 27, 'name': 'Shounen'}]}}

{'node': {'id': 136, 'title': 'Hunter x Hunter', 'main_picture': {'medium': 'https://api-cdn.myanimelist.net/images/anime/8/19473.jpg', 'large': 'https://api-cdn.myanimelist.net/images/anime/8/19473l.jpg'}, 'genres': [{'id': 1, 'name': 'Action'}, {'id': 2, 'name': 'Adventure'}, {'id': 10, 'name': 'Fantasy'}, {'id': 27, 'name': 'Shounen'}]}}

Note

You can access dictionary properties using square brackets:

19for anime in anime_list:
20    print(f"Title: {anime['node']['title']}")
21    print(f"Genres: {anime['node']['genres']}\n")

Output

Title: Hunter x Hunter (2011)
Genres: [{'id': 1, 'name': 'Action'}, {'id': 2, 'name': 'Adventure'}, {'id': 10, 'name': 'Fantasy'}, {'id': 27, 'name': 'Shounen'}]

Title: Hunter x Hunter
Genres: [{'id': 1, 'name': 'Action'}, {'id': 2, 'name': 'Adventure'}, {'id': 10, 'name': 'Fantasy'}, {'id': 27, 'name': 'Shounen'}]

get_anime_list_in_json()

 1from os import getenv
 2from dotenv import load_dotenv
 3
 4from myanimelistpy.myanimelist import MyAnimeList
 5
 6load_dotenv()
 7
 8CLIENT_ID = getenv("CLIENT_ID")
 9
10if __name__ == "__main__":
11    my_anime_list = MyAnimeList(client_id=CLIENT_ID)
12
13    anime_list = my_anime_list.get_anime_list_in_json(
14        anime_name = "Hunter x Hunter",
15        limit      = 2,
16        fields     = ["num_episodes"]
17    )
18
19    print(anime_list)

Output

{"data":[{"node": {"id": 11061, "title": "Hunter x Hunter (2011)", "main_picture": {"medium": "https://api-cdn.myanimelist.net/images/anime/1337/99013.jpg", "large": "https://api-cdn.myanimelist.net/images/anime/1337/99013l.jpg"}, "num_episodes": 148}}, {"node": {"id": 136, "title": "Hunter x Hunter", "main_picture": {"medium": "https://api-cdn.myanimelist.net/images/anime/8/19473.jpg", "large": "https://api-cdn.myanimelist.net/images/anime/8/19473l.jpg"}, "num_episodes": 62}}]}

Note

JSON Viewer

{
    "data": [
        {
            "node": {
                "id": 11061,
                "title": "Hunter x Hunter (2011)",
                "main_picture": {
                "medium": "https://api-cdn.myanimelist.net/images/anime/1337/99013.jpg",
                "large": "https://api-cdn.myanimelist.net/images/anime/1337/99013l.jpg"
                },
                "num_episodes": 148
            }
        },
        {
            "node": {
                "id": 136,
                "title": "Hunter x Hunter",
                "main_picture": {
                "medium": "https://api-cdn.myanimelist.net/images/anime/8/19473.jpg",
                "large": "https://api-cdn.myanimelist.net/images/anime/8/19473l.jpg"
                },
                "num_episodes": 62
            }
        }
    ]
}