jikanpy
Advanced tools
JikanPy is a Python wrapper for Jikan, providing bindings for all API functionality, and supports Python 3.6+. Because it is intended to be pretty much identical, please consult Jikan's documentation for thornier details on how it is meant to be used. Perhaps most importantly, JikanPy does not make any attempts to rate limit itself, so use it as responsibly as you would use the API primitively and remember that Jikan API has limitations, check out this section of documentation in order to see to what extent the API is limited or throttled.
You can use either Jikan or AioJikan depending on whether you want a synchronous wrapper class or an asynchronous wrapper class respectively. More usage examples are below.
In addition to the typical response from the Jikan API, each response contains two additional fields:
jikan_url: The URL that was requested; for example: https://api.jikan.moe/v3/anime/1.headers: The response headers from Jikan, detailed here.$ pip install jikanpy
Below are some basic examples of how to use Jikan and AioJikan. Please read the documentation below to see all the methods and more examples.
from jikanpy import Jikan
jikan = Jikan()
mushishi = jikan.anime(457)
mushishi_with_eps = jikan.anime(457, extension='episodes')
search_result = jikan.search('anime', 'Mushishi', page=2)
winter_2018_anime = jikan.season(year=2018, season='winter')
archive = jikan.season_archive()
import asyncio
from jikanpy import AioJikan
async def main():
async with AioJikan() as aio_jikan:
mushishi = await aio_jikan.anime(457)
fma = await aio_jikan.manga(25)
ginko = await aio_jikan.character(425)
kana_hanazawa = await aio_jikan.person(185)
naruto = await aio_jikan.search(search_type='anime', query='naruto')
# You can also construct AioJikan like below, but make sure to close the object
aio_jikan_2 = AioJikan()
mushishi = await aio_jikan.anime(457)
await aio_jikan_2.close()
asyncio.run(main())
Check out the documentation here.
If you're running an instance of jikan-rest on your system, and want to use that instead of api.jikan.moe, you can pass that to Jikan:
from jikanpy import Jikan
jikan = Jikan(selected_base='http://localhost:8000/v3')
If you want to use your own Requests session, you can do that too.
import requests
from jikanpy import Jikan
session = requests.Session()
# Set custom persistent headers that will be used with all HTTP requests with your session
session.headers.update({'x-test': 'true'})
jikan = Jikan(session=session)
You can use any or all of these constructor arguments when creating an instance of Jikan.
AioJikan also has selected_base and session (although AioJikan uses AioHTTP
session, not Requests).
import aiohttp
import asyncio
from jikanpy import AioJikan
async def main():
# Construct AioJikan with own base URL and custom AioHTTP session with custom persistent headers
session = aiohttp.ClientSession(headers={'x-test': 'true'})
aio_jikan = AioJikan(selected_base='http://localhost:8000/v3', session=session)
await session.close()
asyncio.run(main())
# In root of repository
$ pytest
data_file, just read it while building releases. Previously this could cause CHANGELOG.md to be installed into the users data dir (/usr/ or ~/.local/ depending on how its installed). See #90other and unknown for the parameter day in schedule methodstatus request is called with arguments in meta methodpage parameter to manga endpointNotImplementedErrorepisodesapi.jikan.moe/v3api.jikan.moeFAQs
Python wrapper for the Jikan API
We found that jikanpy demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Socket uncovered four malicious NuGet packages targeting ASP.NET apps, using a typosquatted dropper and localhost proxy to steal Identity data and backdoor apps.
Research
An emerging npm supply chain attack that infects repos, steals CI secrets, and targets developer AI toolchains for further compromise.
Company News
Socket is proud to join the OpenJS Foundation as a Silver Member, deepening our commitment to the long-term health and security of the JavaScript ecosystem.