Skip to main content

An API wrapper for Wanikani (V2)

Project description

wk_logo wanikani_api Documentation Status Updates

An API wrapper for Wanikani (V2)


  • Easy access to Wanikani resources associated to your account.

  • Automatic handling of pagination.

  • Automatic fetching of related Subjects


>>> from wanikani_api.client import Client
>>> v2_api_key = "drop_your_v2_api_key_in_here" # You can get it here:
>>> client = Client(v2_api_key)
>>> user_information = client.user_information()
>>> print(user_information)
UserInformation{ username:Tadgh11, level:8, max_level_granted_by_subscription:60, profile_url: started_at:2013-07-09 12:02:54.952786+00:00, subscribed:True, current_vacation_started_at:None }
>>> all_vocabulary = client.subjects(types="vocabulary")
>>> for vocab in all_vocabulary:
>>>     print(vocab.meanings[0].meaning) #Vocabulary may have multiple meanings, we just grab the first in the list.
One Thing
Seven Things
Nine Things


  • Make use of ETags for caching

  • simplify API

  • Improve automatic prefetching of subjects when relevant.


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


0.5.0 (2020-08-18)

  • Remove mock responses that included stage names.

0.5.0 (2020-08-18)

  • Remove passed from resource.

  • Remove srs_stage_name from assignments and reviews

0.4.0 (2020-04-30)

  • Add Preferences to User Information

  • Add Subscription to User Information

0.3.0 (2019-11-09)

  • Add auxiliary_meanings to Subject

0.2.1 (2019-11-05)

  • Fix crash caused by WK removing a field from their API.

0.1.1 (2018-06-26)

  • Change Assignment endpoint to reflect the newly dropped fields from the api (level specifically).

  • Add some proper String representation

  • Work on the Etag cache, bringing it closer to completion.

0.1.0 (2018-06-26)

  • First release on PyPI.

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

wanikani_api-0.6.1.tar.gz (30.4 kB view hashes)

Uploaded source

Built Distribution

wanikani_api-0.6.1-py2.py3-none-any.whl (14.0 kB view hashes)

Uploaded py2 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