Readwise

readwise.list_highlights

List highlights, newest first, optionally from one book or changed since a date. Highlight and book IDs are integers. Readwise allows 20 of these calls a minute.

readwise.list_books

List the books, articles, tweets and podcasts that have highlights, with how many each has. Book IDs are integers. Readwise allows 20 of these calls a minute.

readwise.export_highlights

Export books with all their highlights in one go, the way to sync everything changed since a date. Follow nextPageCursor until it is null.

readwise.create_highlight writes

Add a highlight, filed under the book with this title and author, which is created if it doesn't exist. Highlights that repeat the same text, title, author and source URL aren't duplicated.

readwise.get_daily_review

Get today's Daily Review, the highlights Readwise picked to resurface. Fails with Review not found when there isn't one.

readwise.list_documents

List documents saved in Reader, optionally by location, category or tag. Document IDs are strings like 01gwfvp9pyaabcdgmx14f6ha0. Highlights and notes are documents too, with parent_id set. Reader allows 20 of these calls a minute.

readwise.save_document writes

Save a URL to Reader, scraped by Reader unless html is given. Saving a URL that is already there returns the existing document. Returns the document ID and its Reader URL.

readwise.update_document writes

Move a Reader document, e.g. to archive or later, or change its title, tags or note. Only the fields given change; tags replaces the whole list. Highlights only take notes and tags.

readwise.api_get

Send a GET request to any Readwise API path under https://readwise.io/api and return the response. For endpoints the named tools don't cover.

readwise.api_request writes

Send a POST, PUT, PATCH or DELETE request to any Readwise API path under https://readwise.io/api.