AniKimi API
Features of AniKimi
- Custom url changing option.
- Statically-Typed, No more annoying JSON responses.
- Autocomplete supported by most IDE's.
- Complete solution.
- Faster response.
- Less CPU consumption.
Installing
Using Pypi
$ pip3 install anikimiapi
Getting Started
Pre-Requisites
-
Getting Required Tokens
- Visit the GogoAnime Website.
- Login or SignUp using ur email or google.
- Add an extension to your browser named Get cookies.txt.
- Now in the GogoAnime Website, right click and select "Get cookies.txt"
- A
.txtfile will be downloaded. - In the
.txtfile, find the name "gogoanime" and "auth". - Copy the respective tokens on the right side of the above names.
- Keep it safely, since its your private credentials.
Diving into the API
Authorize the API
To Authorize the API, use AniKimi class. You can also import it from other files. It also supports cross imports. But all API request should be made using this class only.
from anikimiapi import AniKimi
# Initialize AniKimi class
anime = AniKimi(
gogoanime_token="the saved gogoanime token",
auth_token="the saved auth token",
host="https://gogoanime.pe/"
)
Note: If GogoAnime changes their domain, use the 'host' parameter. Otherwise, leave it blank. This parameter was optional and defaults to https://gogoanime.pe/
Getting Anime search results
You can search anime by using search_anime method, It returns the search results as ResultObject which contains two arguments, the title and animeid.
from anikimiapi import AniKimi
anime = AniKimi(
gogoanime_token="the saved gogoanime token",
auth_token="the saved auth token"
)
# Search Anime
results = anime.search_anime(query="tokikaku kawaii")
for i in results:
print(i.title) # (or)
print(i.animeid)
Note: If no search results found, the API will raise
NoSearchResultsErrorerror. Make sure to handle it.
Getting details of a specific Anime
You can the basic information about a specific anime with animeid using get_details method. It will return anime details as MediaInfoObject.
The MediaInfoObject contains the following arguments,
- title
- other_names
- season
- year
- status
- genres
- episodes
- image_url
- summary
from anikimiapi import AniKimi
anime = AniKimi(
gogoanime_token="the saved gogoanime token",
auth_token="the saved auth token"
)
# Get anime Details
details = anime.get_details(animeid="clannad-dub")
print(details.title)
print(details.genres) # And many more...
Note: If an Invalid
animeidis given, the API will raiseInvalidAnimeIdError. Make sure to handle it.
Getting the Anime Links
You can simply get the streamable and downloadable links of a specific episode of an Anime by its animeid and episode_num using get_episode_link method. It will return anime links in MediaLinksObject.
The MediaLinksObject returns the links, if available. Otherwise, it will return None. The MediaLinksObject has the following arguments,
- link_hdp
- link_360p
- link_480p
- link_720p
- link_1080p
- link_streamsb
- link_xstreamcdn
- link_streamtape
- link_mixdrop
- link_mp4upload
- link_doodstream
from anikimiapi import AniKimi
anime = AniKimi(
gogoanime_token="the saved gogoanime token",
auth_token="the saved auth token"
)
# Getting Anime Links
anime_link = anime.get_episode_link(animeid="clannad-dub", episode_num=3)
print(anime_link.link_hdp)
print(anime_link.link_720p)
print(anime_link.link_streamsb) # And many more...
Note: If invalid
animeidorepisode_numis passed, the API will returnInvalidAnimeIdError. Make sure to handle it.If the given
gogoanime_tokenandauth_tokenare invalid, the API will raiseInvalidTokenError. So, be careful of that.
Getting a List of anime by Genre
You can also get the List of anime by their genres using get_by_genres method. This method will return results as a List of ResultObject.
Currently, the following genres are supported,
- action
- adventure
- cars
- comedy
- dementia
- demons
- drama
- dub
- ecchi
- fantasy
- game
- harem
- hentai - Temporarily Unavailable
- historical
- horror
- josei
- kids
- magic
- martial-arts
- mecha
- military
- music
- mystery
- parody
- police
- psychological
- romance
- samurai
- school
- sci-fi
- seinen
- shoujo
- shoujo-ai
- shounen-ai
- shounen
- slice-of-life
- space
- sports
- super-power
- supernatural
- thriller
- vampire
- yaoi
- yuri
from anikimiapi import AniKimi
anime = AniKimi(
gogoanime_token="the saved gogoanime token",
auth_token="the saved auth token"
)
# Getting anime list by genres
gen = anime.get_by_genres(genre_name="romance", page=1)
for result in gen:
print(result.title)
print(result.animeid)
Note: If invalid
genre_nameorpageis passed, the API will raiseInvalidGenreNameError. Make sure to handle it.
Getting List of Airing Anime (v2 API New Feature)
You can get a List of currently Airing Anime using get_airing_anime method. This method will return results as a List of ResultObject.
from anikimiapi import AniKimi
anime = AniKimi(
gogoanime_token="the saved gogoanime token",
auth_token="the saved auth token"
)
# Getting Airing Anime List
airing = anime.get_airing_anime(count=15)
for i in airing:
print(i.title)
print(i.animeid)
Note: If the value of count exceeds 20, The API will raise
AiringIndexError. So, pass a value less than or equal to 20.
