Search highlights using semantic (vector), full-text, or hybrid search.

Use 'semantic' for concept/meaning queries like 'ideas about habit formation'. Use 'fulltext' for exact phrase matching like 'atomic habits'. Use 'hybrid' (default) when unsure — combines both signals.

Returns highlights with book title, author, and source URL inline.

List highlights with optional filtering by book, tag, or recency.

Use updated_after with an ISO 8601 date string to get recent highlights, e.g. '2024-01-01' or '2024-01-01T00:00:00Z'.

Returns highlights plus total count and next_page for pagination.

Get a single highlight by ID with book metadata included.

Returns the full highlight including text, note, tags, book title, book author, and source URL.

Create a new highlight on a book.

Requires the highlight text and the book_id it belongs to. Optionally add a note and tags. Returns the full created highlight.

Update an existing highlight's text or note.

Only the provided fields are updated. Returns the full updated highlight.

Delete a highlight by ID.

Returns a confirmation with the deleted highlight's ID.

List books and sources with optional filtering.

category accepts: 'books', 'articles', 'tweets', 'podcasts', 'supplementals'. Use num_highlights_gte to filter to sources with at least N highlights. Use updated_after with an ISO 8601 date to get recently updated sources.

Get a single book/source by ID.

Returns full book metadata including title, author, category, source, highlight count, cover image URL, and source URL.

List all tags in your Readwise library.

Returns every tag with its ID and name. No pagination needed — tag collections are typically small.

Create a new tag.

Returns the created tag with its ID and name.

Delete a tag by ID.

Returns a confirmation with the deleted tag's ID.

Add or remove a tag on a highlight.

Use action='add' to tag a highlight (creates the tag if it doesn't exist). Use action='remove' to untag it. Returns the highlight's updated list of tag names.

List documents in Readwise Reader with optional filters.

location accepts: 'new' (inbox), 'later', 'shortlist', 'archive', 'feed'. category accepts: 'article', 'email', 'rss', 'highlight', 'note', 'pdf', 'epub', 'tweet', 'video'. Use updated_after with an ISO 8601 date to get recently updated docs.

Get a single Reader document by ID with full content.

Returns the complete document including title, author, content, summary, reading progress, tags, and source URL.

Save a URL to Readwise Reader.

This is the primary way to add content to Reader. The service fetches and parses the article automatically. Only http:// and https:// URLs are accepted.

location controls where it appears: 'new' (inbox), 'later', 'shortlist', or 'archive'. Default is 'new'.

Update the reading progress for a Reader document.

reading_progress is a float from 0.0 (unread) to 1.0 (finished). Returns the updated document.

Bulk export highlights, optionally filtered by date or specific books.

Use cursor from a previous response to paginate through large exports. Each result includes the full highlight with book metadata attached.

This uses the export endpoint — use it for bulk data retrieval, not for interactive queries. For interactive use, prefer search_highlights or list_highlights instead.