Kavita Stats API

The Stats API from Kavita — 34 operation(s) for stats.

GitHub OpenAPI

Operations 34

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/Stats/server/stats Get overall Kavita server stats · Get api stats server stats #
Ask an LLM
“How many books, comics and manga does my Kavita server hold?”
“What are the overall server statistics for Kavita?”
Tell an agent
Show the server's overall statistics.
Get the total number of books, comics and manga on the server.
GET /api/Stats/server/count/publication-status Count items by publication status · Get api stats server count publication status #
Ask an LLM
“How many comics are still in publication versus finished?”
“Can I count series by their publication status?”
Tell an agent
Count the series on my server by publication status.
Show how many series are still in publication versus finished.
GET /api/Stats/server/count/manga-format Count manga by format · Get api stats server count manga format #
Ask an LLM
“How many manga are in digital format versus print?”
“Can I break down my manga collection by format?”
Tell an agent
Count the manga on my server by format.
Show how many manga are digital versus print.
GET /api/Stats/popular-decades List the most popular decades for series · Get api stats popular decades #
Ask an LLM
“Which decades are the most popular for series on my server?”
“What decade do readers like the most?”
Tell an agent
List the most popular decades for series.
Show which decades readers favor most.
GET /api/Stats/popular-libraries List the most popular libraries · Get api stats popular libraries #
Ask an LLM
“Which libraries are the most popular on my server?”
“What are the top libraries by usage?”
Tell an agent
List the most popular libraries on my server.
Show which libraries readers use most.
GET /api/Stats/popular-series List the most popular series · Get api stats popular series #
Ask an LLM
“Which series are the most popular on my server?”
“What are the top series by readership?”
Tell an agent
List the most popular series on my server.
Show which series readers like the most.
GET /api/Stats/popular-reading-list List the top 5 most popular reading lists · Gets the top 5 most popular reading lists. #
Ask an LLM
“What are the top 5 most popular reading lists?”
“Which reading lists are most used?”
Tell an agent
Show the top 5 most popular reading lists.
List the most used reading lists.
GET /api/Stats/popular-genres List the most popular genres · Get api stats popular genres #
Ask an LLM
“Which genres are the most popular on my server?”
“What are the top genres by readership?”
Tell an agent
List the most popular genres on my server.
Show which genres readers favor most.
GET /api/Stats/popular-tags List the most popular tags · Get api stats popular tags #
Ask an LLM
“Which tags are the most popular on my server?”
“What are the top tags by usage?”
Tell an agent
List the most popular tags on my server.
Show which tags readers use most.
GET /api/Stats/popular-people List popular creators by role · Get api stats popular people #
Ask an LLM
“Who are the most popular writers, pencillers and letterers on my server?”
“Can I see popular creators grouped by role?”
Tell an agent
List the most popular creators in role {role}.
Show the top creators for {role} on my server.
GET /api/Stats/most-active-users List the most active readers over a period · Top 5 most active readers for the given timeframe #
Ask an LLM
“Who are the most active readers on my server this month?”
“Can I limit the active users list to certain libraries?”
Tell an agent
List the most active readers from {StartDate} to {EndDate}.
Show the top active readers in libraries {Libraries}.
GET /api/Stats/server/file-breakdown Break down files by size and format · A breakdown of different files, their size, and format #
Ask an LLM
“What is the file size and format breakdown of my library?”
“Which file formats take up the most space?”
Tell an agent
Show a breakdown of files by size and format.
Break down my library files by format and size.
GET /api/Stats/server/file-extension List file paths for a file extension · Generates a csv of all file paths for a given extension #
Ask an LLM
“Can I get a CSV of all files with a given extension?”
“What files end in .pdf on my server?”
Tell an agent
Generate a CSV of file paths for extension {fileExtension}.
List every file on my server with the {fileExtension} extension.
GET /api/Stats/reading-counts Get reading history counts by day · Returns reading history events for a give or all users, broken up by day, and… #
Ask an LLM
“How many books did readers finish each day?”
“Can I see reading history for a single user?”
Tell an agent
Show reading history events by day from {StartDate} to {EndDate}.
Get reading counts for user {userId}.
GET /api/Stats/day-breakdown Break down reading by day for a user · Get api stats day breakdown #
Ask an LLM
“How does one user's reading break down day by day?”
“Can I see daily reading counts for a single reader?”
Tell an agent
Break down daily reading for user {userId}.
Show how user {userId} read each day.
GET /api/Stats/pages-per-year Count pages read per year for a user · Returns a count of pages read per year for a given userId #
Ask an LLM
“How many pages did a reader finish each year?”
“Can I see one user's page count by year?”
Tell an agent
Count pages read per year for user {userId}.
Show how many pages user {userId} read each year.
GET /api/Stats/words-per-year Count words read per year for a user · Returns a count of words read per year for a given userId #
Ask an LLM
“How many words did a reader read each year?”
“Can I see one user's word count by year?”
Tell an agent
Count words read per year for user {userId}.
Show how many words user {userId} read each year.
GET /api/Stats/files-added-over-time Get books added to Kavita over time · Get api stats files added over time #
Ask an LLM
“How many books have been added to Kavita per month?”
“Can I chart files added over time rather than total books?”
Tell an agent
Get the files added over time stat.
Show how many books were added each month.
GET /api/Stats/device/client-type Break down client types for the current month · Returns client type breakdown for the current month #
Ask an LLM
“Which client types are most used on my server this month?”
“What share of readers use the web app versus mobile?”
Tell an agent
Show the client type breakdown for this month.
Break down current-month usage by client type.
GET /api/Stats/device/device-type Break down desktop vs mobile usage · Desktop vs Mobile spread over this month #
Ask an LLM
“Is my library more popular on desktop or mobile?”
“What is the desktop vs mobile split for this month?”
Tell an agent
Show the desktop vs mobile split for this month.
Break down current-month usage by device type.
GET /api/Stats/reading-activity Show a user's reading activity over time · Get api stats reading activity #
Ask an LLM
“How much has a user read over a given period?”
“Can I see reading activity broken down by library?”
Tell an agent
Show reading activity from {start} to {end}.
Show reading activity for user {user} in libraries {libraries}.
GET /api/Stats/reading-pace Show how fast a user reads books and comics · Get api stats reading pace #
Ask an LLM
“How many pages or words does a user read per session?”
“Can I see reading pace for books only?”
Tell an agent
Show reading pace from {start} to {end}.
Show reading pace for books only: {books_only}.
GET /api/Stats/genre-breakdown Show a user's favorite genres · Returns the top 10 genres that the user likes reading #
Ask an LLM
“Which genres does a user like to read most?”
“What are the top 10 genres in a library?”
Tell an agent
Show the top 10 favorite genres from {start} to {end}.
Show favorite genres for user {user} in libraries {libraries}.
GET /api/Stats/tag-breakdown Show a user's favorite tags · Returns top 10 tags that user likes reading #
Ask an LLM
“Which tags does a user apply most to their books?”
“What are the top 10 tags a user likes?”
Tell an agent
Show the top 10 favorite tags from {start} to {end}.
Show favorite tags for user {user} in libraries {libraries}.
GET /api/Stats/page-spread Show page reading spread over time · Get api stats page spread #
Ask an LLM
“How are pages read spread across the day?”
“Can I see a page-reading spread chart?”
Tell an agent
Show the page spread from {start} to {end}.
Show page spread for user {user} in libraries {libraries}.
GET /api/Stats/word-spread Show word reading spread over time · Get api stats word spread #
Ask an LLM
“How are words read spread across the day?”
“Can I see a word-reading spread chart?”
Tell an agent
Show the word spread from {start} to {end}.
Show word spread for user {user} in libraries {libraries}.
GET /api/Stats/favorite-authors Show a user's favorite authors · Get api stats favorite authors #
Ask an LLM
“Which authors does a user read most?”
“What are the top favorite authors in a library?”
Tell an agent
Show favorite authors from {start} to {end}.
Show favorite authors for user {user} in libraries {libraries}.
GET /api/Stats/avg-time-by-hour Show average reading time by hour · Returns the avg time read by hour in the given filter #
Ask an LLM
“When does a user read most on average?”
“What is the average reading time per hour of the day?”
Tell an agent
Show average reading time by hour from {start} to {end}.
Show average reading time by hour for user {user} in libraries {libraries}.
GET /api/Stats/reads-by-month Show reads per month · Get api stats reads by month #
Ask an LLM
“How many reads happened each month?”
“Can I see a monthly reads chart?”
Tell an agent
Show reads per month from {start} to {end}.
Show monthly reads for user {user} in libraries {libraries}.
GET /api/Stats/total-reads Count total reads · Returns the total amount reads in the given filter #
Ask an LLM
“How many reads has a user had in total?”
“What is the grand total of reads for a user?”
Tell an agent
Count total reads for user {user}.
Give me the total number of reads.
GET /api/Stats/user-stats Show a user's overall reading stats · Get api stats user stats #
Ask an LLM
“What are a user's overall reading stats?”
“Can I see a summary of a user's reading activity?”
Tell an agent
Show overall reading stats from {start} to {end}.
Show overall reading stats for user {user} in libraries {libraries}.
GET /api/Stats/user-read Show a user's reading history · Get api stats user read #
Ask an LLM
“What has a user read recently?”
“Can I see a user's reading history?”
Tell an agent
Show the reading history for user {user}.
List what user {user} has read.
GET /api/Stats/reading-history Get a user's reading session history · Return a user's reading session history #
Ask an LLM
“Can I pull a user's reading session history?”
“Is it possible to filter reading history to a date range?”
Tell an agent
Get reading history from {StartDate} to {EndDate}.
Show reading sessions from libraries {Libraries}.
GET /api/Stats/reading-history/series/{seriesId} Show reading history for one series · Return the authenticated users reading session history for a given series #
Ask an LLM
“How far has a user read in a particular series?”
“Can I see the reading session history for one series?”
Tell an agent
Show reading history for series {series}.
Show reading sessions for series {series} in timezone {tz}.

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-stats-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-stats-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kavita Stats 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 (57 KB total) ---
# Full source: https://artifacts.apis.io/kavita/openapi/kavita-stats-api-openapi.yml