An API for your Kindle data
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
lector Bump version May 20, 2017
.gitignore Added proper package structure and setup script Nov 11, 2015 Bump version May 20, 2017
LICENSE Initial commit Aug 15, 2015 Added missing files to manifest Nov 11, 2015 Add usage example Oct 8, 2016
requirements.txt Rebranded to Lector, bumped selenium version Nov 11, 2015 Mostly cosmetic changes Dec 24, 2015


An API for your Kindle data.

Python bindings are provided but any language that can run the javascript found in from within a Kindle Cloud Reader session may easily access this data.



  • OS X (Homebrew)
    • brew install phantomjs
  • Ubuntu (at least 14.04)
    • Guide provided and maintained by @julionc here


import lector

api = lector.KindleCloudReaderAPI('my_amazon_username', 'my_amazon_password')
my_library = api.get_library_metadata()
book = my_library[0]
book_progress = api.get_book_progress(book.asin)
_, current_page, last_page = book_progress.page_nums

print 'Currently reading %s (Page %d of %d)' % (book.title, current_page, last_page)