Kavita Reader API

For all things regarding reading, mainly focusing on non-Book related entities

GitHub OpenAPI

Operations 39

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/Reader/pdf Get the PDF of a chapter · Returns the PDF for the chapterId #
Ask an LLM
“How do I fetch the full PDF of a manga chapter for reading?”
“Can I get a chapter's PDF as images instead of a single file?”
Tell an agent
Get the PDF for chapter {chapterId}.
Download chapter {chapterId} as a PDF with extractPdf {extractPdf}.
GET /api/Reader/image Get one page image of a chapter · Returns an image for a given chapter. Will perform bounding checks #
Ask an LLM
“How do I load a single page of a manga chapter as an image?”
“Does the chapter image endpoint check that the page exists?”
Tell an agent
Get page {page} of chapter {chapterId}.
Load chapter {chapterId} page {page} as an image.
GET /api/Reader/thumbnail Get a thumbnail of a chapter page · Returns a thumbnail for the given page number #
Ask an LLM
“How do I get a small thumbnail of a page in a chapter?”
“Can I fetch a thumbnail for a specific page number?”
Tell an agent
Get a thumbnail for page {pageNum} of chapter {chapterId}.
Fetch thumbnail {pageNum} in chapter {chapterId}.
GET /api/Reader/bookmark-image Get an image from a user's bookmarks · Returns an image for a given bookmark series. #
Ask an LLM
“How do I read a page from my own bookmarked manga?”
“Can I fetch a bookmarked page using my API key?”
Tell an agent
Get bookmark {page} of series {seriesId} for my user.
Show my bookmarked page {page} in series {seriesId}.
GET /api/Reader/file-dimensions Get page dimensions of a chapter · Returns the file dimensions for all pages in a chapter. #
Ask an LLM
“How many pages does a chapter have and what are their sizes?”
“Does the chapter dimensions call cache the images?”
Tell an agent
Get the file dimensions of chapter {chapterId}.
Get page sizes for chapter {chapterId} with extractPdf {extractPdf}.
GET /api/Reader/chapter-info Get information about a chapter · Returns various information about a Chapter. #
Ask an LLM
“What do I need to know before starting to read a chapter?”
“Can I include page dimensions when fetching chapter info?”
Tell an agent
Get chapter info for chapter {chapterId}.
Fetch chapter {chapterId} with dimensions {includeDimensions}.
GET /api/Reader/bookmark-info Get bookmark info for a series · Returns various information about all bookmark files for a Series. #
Ask an LLM
“What chapters in a series have bookmarks?”
“Can I get all bookmarked files for a series?”
Tell an agent
Get bookmark info for series {seriesId}.
List bookmarked files in series {seriesId} with dimensions {includeDimensions}.
POST /api/Reader/mark-chapter-read Mark a chapter as read · Mark a single chapter as read #
Ask an LLM
“How do I mark one chapter as read so it stops showing in my unread list?”
“Can I generate a reading session when marking a chapter read?”
Tell an agent
Mark chapter {chapterId} as read in series {seriesId}.
Mark chapter {chapterId} read with generateReadingSession {generateReadingSession}.
POST /api/Reader/mark-read Mark a series as read · Marks a Series as read. #
Ask an LLM
“How do I mark an entire series as read?”
“Can I generate a reading session when marking a series read?”
Tell an agent
Mark series {seriesId} as read.
Mark series {seriesId} read with generateReadingSession {generateReadingSession}.
POST /api/Reader/mark-unread Mark a series as unread · Marks a Series as Unread. #
Ask an LLM
“How do I mark a series as unread again?”
“Can I generate a reading session when marking a series unread?”
Tell an agent
Mark series {seriesId} as unread.
Mark series {seriesId} unread with generateReadingSession {generateReadingSession}.
POST /api/Reader/mark-volume-unread Mark all chapters in a volume as unread · Marks all chapters within a volume as unread #
Ask an LLM
“How do I mark every chapter in one volume as unread?”
“Can I reset a single volume's read status?”
Tell an agent
Mark all chapters in volume {volumeId} of series {seriesId} as unread.
Reset volume {volumeId} read status for series {seriesId}.
POST /api/Reader/mark-volume-read Mark all chapters in a volume as read · Marks all chapters within a volume as Read #
Ask an LLM
“How do I mark every chapter in a volume as read?”
“Can I mark a whole volume read in one call?”
Tell an agent
Mark all chapters in volume {volumeId} of series {seriesId} as read.
Mark volume {volumeId} read for series {seriesId}.
POST /api/Reader/mark-multiple-read Mark chapters in several volumes as read · Marks all chapters within a list of volumes as Read. #
Ask an LLM
“How do I mark chapters across multiple volumes as read at once?”
“Can I mark a list of chapters as read in one request?”
Tell an agent
Mark chapters {chapterIds} in series {seriesId} as read.
Mark volumes {volumeIds} of series {seriesId} as read.
POST /api/Reader/mark-multiple-unread Mark chapters in several volumes as unread · Marks all chapters within a list of volumes as Unread. #
Ask an LLM
“How do I mark chapters across several volumes as unread?”
“Can I mark a list of chapters unread in one request?”
Tell an agent
Mark chapters {chapterIds} in series {seriesId} as unread.
Mark volumes {volumeIds} of series {seriesId} as unread.
POST /api/Reader/mark-multiple-series-read Mark several series as read in one request · Marks all chapters within a list of series as Read #
Ask an LLM
“How do I mark every chapter in several series as read at once?”
“Can I mark a whole batch of series as read in a single call?”
Tell an agent
Mark every chapter in series {seriesIds} as read in one batch.
Batch-mark series {seriesIds} as read, with the reading session flag set to {generateReadingSession}.
POST /api/Reader/mark-multiple-series-unread Mark chapters of several series as unread · Marks all chapters within a list of series as Unread #
Ask an LLM
“How do I mark all chapters of several series as unread?”
“Can I clear read progress for a batch of series at once?”
Tell an agent
Mark chapters of series {seriesIds} as unread.
Mark series {seriesIds} chapters unread and set generate session to {generateReadingSession}.
GET /api/Reader/get-progress Get my progress in a chapter · Returns Progress (page number) for a chapter for the logged in user #
Ask an LLM
“What page have I reached in a chapter?”
“Can I check my reading progress on one chapter?”
Tell an agent
Get my progress in chapter {chapterId}.
Show the page I last read in chapter {chapterId}.
POST /api/Reader/progress Save my reading progress on a chapter · Save page against Chapter for authenticated user #
Ask an LLM
“How do I save which page I stopped on in a chapter?”
“What fields are required to record chapter progress?”
Tell an agent
Save progress to page {pageNum} in chapter {chapterId}, volume {volumeId}, series {seriesId}, library {libraryId}.
Record chapter {chapterId} progress {pageNum} for series {seriesId}, volume {volumeId}, library {libraryId}.
GET /api/Reader/continue-point Find my next chapter to read · Continue point is the chapter which you should start reading again from. #
Ask an LLM
“Which chapter should I start reading next?”
“Can I get my continue point for a series?”
Tell an agent
Get my continue point for series {seriesId}.
Find the next chapter to read in series {seriesId}.
GET /api/Reader/has-progress Check if I have progress on a series · Returns if the user has reading progress on the Series #
Ask an LLM
“Do I have any reading progress on a series?”
“Can I check whether I've read anything in a series?”
Tell an agent
Check if I have progress on series {seriesId}.
Tell me whether I've read anything in series {seriesId}.
GET /api/Reader/chapter-bookmarks Get a chapter's bookmarked pages · Returns a list of bookmarked pages for a given Chapter #
Ask an LLM
“Which pages have I bookmarked in a particular chapter?”
“Can I see the highlighted spots in one chapter?”
Tell an agent
Show the bookmarked pages for chapter {chapterId}.
List my bookmarks in chapter {chapterId}.
POST /api/Reader/all-bookmarks List all my bookmarks across books · Returns a list of all bookmarked pages for a User #
Ask an LLM
“What pages have I bookmarked across every book I read?”
“Can I get a master list of all my bookmarks?”
Tell an agent
List all my bookmarks.
Show every bookmarked page across all books.
POST /api/Reader/remove-bookmarks Clear bookmarks for a series · Removes all bookmarks for all chapters linked to a Series #
Ask an LLM
“How do I clear every bookmark I made in one series?”
“Can I wipe all bookmarks for a series at once?”
Tell an agent destructive · confirm first
Remove all bookmarks for series {seriesId}.
Clear every bookmark in series {seriesId}.
POST /api/Reader/bulk-remove-bookmarks Clear bookmarks for several series · Removes all bookmarks for all chapters linked to a Series #
Ask an LLM
“Can I clear bookmarks across a batch of series in one call?”
“How do I remove bookmarks from several series at once?”
Tell an agent destructive · confirm first
Remove bookmarks for series {seriesIds}.
Clear all bookmarks in series {seriesIds}.
GET /api/Reader/volume-bookmarks Get a volume's bookmarked pages · Returns all bookmarked pages for a given volume #
Ask an LLM
“Which pages have I bookmarked in one volume of a series?”
“Can I see my bookmarks for a single volume?”
Tell an agent
Show the bookmarked pages for volume {volumeId}.
List my bookmarks in volume {volumeId}.
GET /api/Reader/series-bookmarks Get a series' bookmarked pages · Returns all bookmarked pages for a given series #
Ask an LLM
“Which pages have I bookmarked across a whole series?”
“Can I see my bookmarks for every volume in a series?”
Tell an agent
Show the bookmarked pages for series {seriesId}.
List my bookmarks across series {seriesId}.
POST /api/Reader/bookmark Bookmark a page in a chapter · Bookmarks a page against a Chapter #
Ask an LLM
“How do I bookmark a page in a chapter so I can find it later?”
“Does bookmarking a page cache the chapter files?”
Tell an agent
Bookmark page {page} in chapter {chapterId} of series {seriesId}, volume {volumeId}.
Save a bookmark at page {page} in chapter {chapterId}, series {seriesId}, volume {volumeId}.
POST /api/Reader/unbookmark Remove a bookmark from a chapter · Removes a bookmarked page for a Chapter #
Ask an LLM
“How do I remove a bookmark I added to a chapter?”
“Can I clear one specific page bookmark?”
Tell an agent destructive · confirm first
Remove my bookmark at page {page} in chapter {chapterId} of series {seriesId}, volume {volumeId}.
Unbookmark page {page} in chapter {chapterId}, series {seriesId}, volume {volumeId}.
GET /api/Reader/next-chapter Find the next chapter in a series · Returns the next logical chapter from the series #
Ask an LLM
“What chapter comes next in a series after the one I'm reading?”
“Can I jump to the next chapter of a volume?”
Tell an agent
Find the next chapter after chapter {currentChapterId} in series {seriesId}.
Get the next chapter of volume {volumeId} in series {seriesId}.
GET /api/Reader/prev-chapter Find the previous chapter in a series · Returns the previous logical chapter from the series #
Ask an LLM
“What chapter came before the one I'm reading?”
“Can I go back to the previous chapter of a volume?”
Tell an agent
Find the previous chapter before chapter {currentChapterId} in series {seriesId}.
Get the previous chapter of volume {volumeId} in series {seriesId}.
GET /api/Reader/time-left Estimate time to finish a series · For the current user, returns an estimate on how long it would take to finish… #
Ask an LLM
“How long would it take me to finish a series?”
“Can I get a reading time estimate for a series?”
Tell an agent
Estimate how long it would take me to finish series {seriesId}.
Give me a reading time left for series {seriesId}.
GET /api/Reader/time-left-for-chapter Estimate time to finish a chapter · For the current user, returns an estimate on how long it would take to finish… #
Ask an LLM
“How long would it take me to finish the chapter I'm reading?”
“Can I get a reading time estimate for one chapter?”
Tell an agent
Estimate how long it would take me to finish chapter {chapterId} in series {seriesId}.
Give me a reading time left for chapter {chapterId}.
GET /api/Reader/ptoc Get a chapter's personal table of contents · Returns the user's personal table of contents for the given chapter #
Ask an LLM
“What does my personal table of contents look like for a chapter?”
“Can I see the bookmarks I added to a chapter's TOC?”
Tell an agent
Show my personal table of contents for chapter {chapterId}.
Get the TOC entries I added to chapter {chapterId}.
DELETE /api/Reader/ptoc Delete a chapter's personal TOC entry · Deletes the user's personal table of content for the given chapter #
Ask an LLM
“How do I remove one entry from my personal table of contents for a chapter?”
“Can I delete a TOC bookmark by page number?”
Tell an agent destructive · confirm first
Delete my personal TOC entry at page {pageNum} in chapter {chapterId}.
Remove the TOC entry titled {title} from chapter {chapterId}.
POST /api/Reader/create-ptoc Add a personal TOC entry to a chapter · Create a new personal table of content entry for a given chapter #
Ask an LLM
“How do I add a bookmarked TOC entry to a chapter?”
“Do the title and page number of a TOC entry have to be unique?”
Tell an agent
Add a personal TOC entry {title} at page {pageNumber} in chapter {chapterId}, series {seriesId}, volume {volumeId}, library {libraryId}.
Create a TOC bookmark {title} on page {pageNumber} for chapter {chapterId}.
GET /api/Reader/prompt-reread/series Check if a series should be reread · Check if we should prompt the user for rereads for the given series #
Ask an LLM
“Should I reread a series I've already read?”
“Is there a prompt to reread a series?”
Tell an agent
Check whether I should be prompted to reread series {seriesId}.
Tell me if rereading series {seriesId} is recommended.
GET /api/Reader/prompt-reread/volume Check if a volume should be reread · Check if we should prompt the user for rereads for the given volume #
Ask an LLM
“Should I reread a volume I've already read?”
“Is there a prompt to reread a volume?”
Tell an agent
Check whether I should be prompted to reread volume {volumeId} of series {seriesId}.
Tell me if rereading volume {volumeId} in library {libraryId} is recommended.
GET /api/Reader/prompt-reread/chapter Check if a chapter should be reread · Check if we should prompt the user for rereads for the given chapter #
Ask an LLM
“Should I reread a chapter I've already read?”
“Is there a prompt to reread a chapter?”
Tell an agent
Check whether I should be prompted to reread chapter {chapterId} of series {seriesId}.
Tell me if rereading chapter {chapterId} in library {libraryId} is recommended.
GET /api/Reader/first-progress-date Get when a user started reading · Get api reader first progress date #
Ask an LLM
“When did a user first start making progress in the reader?”
“Can I get a user's first progress date?”
Tell an agent
Get the first progress date for user {userId}.
Tell me when user {userId} first made progress.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kavita:kavita-reader-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kavita-reader-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kavita Reader API
  description: Kavita provides a set of APIs authenticated via an Auth Key passed in the `x-api-key` header. Generate an Auth Key under User Settings → Manage Auth Keys, paste it into the Authorize panel, and all Try It requests will include it. Assume all fields of a payload are required unless marked optional. Built against v0.9.1.15
  license:
    name: GPL-3.0
    url: https://github.com/Kareadita/Kavita/blob/develop/LICENSE
  version: 0.9.1.15
servers:
- url: '{protocol}://{hostpath}'
  variables:
    protocol:
      default: http
      enum:
      - http
      - https
    hostpath:
      default: localhost:5000
security:
- AuthKey: []
tags:


# --- truncated at 32 KB (64 KB total) ---
# Full source: https://artifacts.apis.io/kavita/openapi/kavita-reader-api-openapi.yml