Documentation for (and examples of) using the Khan Academy API
Switch branches/tags
Nothing to show
Clone or download
Latest commit 72e1b62 Oct 30, 2018

Khan Academy API

This repository provides documentation and some examples for working with the Khan Academy API.


Documentation can be found on the GitHub project wiki:

  • The Khan Academy API wiki page has general information about how to use the API.
  • The Khan Academy API Authentication wiki page provides more detailed documentation about how to use OAuth 1 to log in as a Khan Academy user and access information.

Unfortunately, not all of the documentation is completely up-to-date, so feel free to file issues if documentation looks wrong or incomplete.

Asking questions and reporting bugs

If you have a question about how to use the API, there are a few ways you can get support:

  • You can ask a StackOverflow question with the khan-academy tag. We watch for new issues with that tag, and you're also likely to get help from other community members.
  • You can file an issue in the issue tracker for this GitHub project. This is especially useful if you find a bug in one of the sample clients or with the API itself.
  • If you already have a contact at Khan Academy (e.g. through a partnership), you can reach out to them.
  • Any other questions can be sent to .

Unfortunately, we're not always actively developing and maintaining the API, so we're unlikely to add significant features and may be slow at responding to questions, but we try to get to every question and we hope you'll still find the existing API useful.

Sample API clients

See the examples directory for a few sample API clients. All example code is MIT licensed.

The most current example client is test_client2, which shows how to connect using the /api/auth2 authentication endpoints.

Here's an example of how you might use it (using the consumer key and secret obtained when registering an app):

$ cd examples/test_client2
$ python
consumer key: [your consumer key]
consumer secret: [your consumer secret]
server base url:

Resource relative url (e.g. /api/v1/playlists): /api/v1/user

{"spawned_by": null, "total_seconds_watched": 140627, ...}

Time: 0.647733926773s


If you want to contribute your own sample client, we'd be happy to include it; just send us a pull request! There's also plenty of room for improvement in the existing clients, so we're happy to accept contributions to those as well.