# Kavita Stats API

**Canonical:** https://apis.io/apis/kavita/kavita-stats-api/  
**Provider:** Kavita — https://apis.io/providers/kavita/  
**Documentation:** https://wiki.kavitareader.com/

Kavita Stats API is one of 48 APIs that [Kavita](https://apis.io/providers/kavita/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Stats. The published artifact set on APIs.io includes an OpenAPI specification.

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

## Operations (34)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/Stats/server/stats` | Get api stats server stats |
| GET | `/api/Stats/server/count/publication-status` | Get api stats server count publication status |
| GET | `/api/Stats/server/count/manga-format` | Get api stats server count manga format |
| GET | `/api/Stats/popular-decades` | Get api stats popular decades |
| GET | `/api/Stats/popular-libraries` | Get api stats popular libraries |
| GET | `/api/Stats/popular-series` | Get api stats popular series |
| GET | `/api/Stats/popular-reading-list` | Gets the top 5 most popular reading lists. |
| GET | `/api/Stats/popular-genres` | Get api stats popular genres |
| GET | `/api/Stats/popular-tags` | Get api stats popular tags |
| GET | `/api/Stats/popular-people` | Get api stats popular people |
| GET | `/api/Stats/most-active-users` | Top 5 most active readers for the given timeframe |
| GET | `/api/Stats/server/file-breakdown` | A breakdown of different files, their size, and format |
| GET | `/api/Stats/server/file-extension` | Generates a csv of all file paths for a given extension |
| GET | `/api/Stats/reading-counts` | Returns reading history events for a give or all users, broken up by day, and… |
| GET | `/api/Stats/day-breakdown` | Get api stats day breakdown |
| GET | `/api/Stats/pages-per-year` | Returns a count of pages read per year for a given userId |
| GET | `/api/Stats/words-per-year` | Returns a count of words read per year for a given userId |
| GET | `/api/Stats/files-added-over-time` | Get api stats files added over time |
| GET | `/api/Stats/device/client-type` | Returns client type breakdown for the current month |
| GET | `/api/Stats/device/device-type` | Desktop vs Mobile spread over this month |
| GET | `/api/Stats/reading-activity` | Get api stats reading activity |
| GET | `/api/Stats/reading-pace` | Get api stats reading pace |
| GET | `/api/Stats/genre-breakdown` | Returns the top 10 genres that the user likes reading |
| GET | `/api/Stats/tag-breakdown` | Returns top 10 tags that user likes reading |
| GET | `/api/Stats/page-spread` | Get api stats page spread |
| GET | `/api/Stats/word-spread` | Get api stats word spread |
| GET | `/api/Stats/favorite-authors` | Get api stats favorite authors |
| GET | `/api/Stats/avg-time-by-hour` | Returns the avg time read by hour in the given filter |
| GET | `/api/Stats/reads-by-month` | Get api stats reads by month |
| GET | `/api/Stats/total-reads` | Returns the total amount reads in the given filter |
| GET | `/api/Stats/user-stats` | Get api stats user stats |
| GET | `/api/Stats/user-read` | Get api stats user read |
| GET | `/api/Stats/reading-history` | Return a user's reading session history |
| GET | `/api/Stats/reading-history/series/{seriesId}` | Return the authenticated users reading session history for a given series |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/kavita/openapi/kavita-stats-api-openapi.yml

## Other Kavita APIs (12)

- [Kavita API](https://apis.io/apis/kavita/kavita-api/)
- [Kavita Account API](https://apis.io/apis/kavita/kavita-account-api/)
- [Kavita Activity API](https://apis.io/apis/kavita/kavita-activity-api/)
- [Kavita Admin API](https://apis.io/apis/kavita/kavita-admin-api/)
- [Kavita Annotation API](https://apis.io/apis/kavita/kavita-annotation-api/)
- [Kavita Book API](https://apis.io/apis/kavita/kavita-book-api/)
- [Kavita Cbl API](https://apis.io/apis/kavita/kavita-cbl-api/)
- [Kavita Chapter API](https://apis.io/apis/kavita/kavita-chapter-api/)
- [Kavita Collection API](https://apis.io/apis/kavita/kavita-collection-api/)
- [Kavita Color Scape API](https://apis.io/apis/kavita/kavita-colorscape-api/)
- [Kavita Device API](https://apis.io/apis/kavita/kavita-device-api/)
- [Kavita Download API](https://apis.io/apis/kavita/kavita-download-api/)

## Tags

Stats

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/kavita/kavita-stats-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/kavita/.