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
.txt
file will be downloaded. - In the
.txt
file, 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
NoSearchResultsError
error. 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
animeid
is 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
animeid
orepisode_num
is passed, the API will returnInvalidAnimeIdError
. Make sure to handle it.If the given
gogoanime_token
andauth_token
are 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_name
orpage
is 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.