Skip to main content

Wrapper for Shikimori API

Project description


Build Status Coverage Status License Shikimori Status PyPI - Python Version

Unofficial wrapper for the Shikimori API


This package requires Python 3.6 or later

pip install shikimori_api



from shikimori_api import Shikimori

session = Shikimori()
api = session.get_api()

api.animes.GET(search='KonoSuba', kind='movie')  # GET /api/animes?search=KonoSuba&kind=movie
api.animes(1).GET()                              # GET /api/animes/1
api.animes(1).screenshots.GET()                  # GET /api/animes/1/screenshots


import json

def token_saver(token: dict):
    with open('token.json', 'w') as f:

session = Shikimori('APP_NAME', client_id='CLIENT_ID', client_secret='CLIENT_SECRET', token_saver=token_saver)

code = input('Authorization Code: ')

After receiving and saving token, you can load it from file:

with open('token.json') as f:
    token = json.load(f)
session = Shikimori('APP_NAME', client_id='CLIENT_ID', client_secret='CLIENT_SECRET',
                    token=token, token_saver=token_saver)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shikimori_api-1.0.1.tar.gz (3.7 kB view hashes)

Uploaded source

Built Distribution

shikimori_api-1.0.1-py3-none-any.whl (4.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page