Kavita Metadata API

The Metadata API from Kavita — 14 operation(s) for metadata.

GitHub OpenAPI

Operations 14

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/Metadata/genres List metadata genres · Fetches genres from the instance #
Ask an LLM
“What genres are available in my Kavita library?”
“Can I get the genre list for just one library?”
Tell an agent
List the metadata genres.
Show genres in libraries {libraryIds}.
POST /api/Metadata/genres-with-counts List genres with series counts · Returns a list of Genres with counts for counts when Genre is on Series/Chapter #
Ask an LLM
“How many series and chapters use each genre?”
“Can I page through genre counts?”
Tell an agent
List genres with counts for each series and chapter.
Show {pageSize} genres per page starting at {pageNumber}.
GET /api/Metadata/people-by-role List people by role · Fetches people from the instance by role #
Ask an LLM
“Who are the writers or artists in my library?”
“Can I list only one role of people?”
Tell an agent
List people with role {role}.
Show the {role} people in my library.
GET /api/Metadata/people List metadata people · Fetches people from the instance #
Ask an LLM
“Who are the creators in my library?”
“Can I get people across several libraries?”
Tell an agent
List the metadata people.
Show people in libraries {libraryIds}.
GET /api/Metadata/tags List metadata tags · Fetches all tags from the instance #
Ask an LLM
“What tags are used across my library?”
“Can I get tags for a single library?”
Tell an agent
List the metadata tags.
Show tags in libraries {libraryIds}.
GET /api/Metadata/readinglist-tags List reading list tags · Fetches Reading List Tags from the instance #
Ask an LLM
“What tags are used on my reading lists?”
“Can I see the reading list tags?”
Tell an agent
List the reading list tags.
Show my reading list tags.
POST /api/Metadata/tags-with-counts List tags with series counts · Returns a list of Tags with counts for counts when Tag is on Series/Chapter #
Ask an LLM
“How many series and chapters use each tag?”
“Can I page through tag counts?”
Tell an agent
List tags with counts for each series and chapter.
Show {pageSize} tags per page starting at {pageNumber}.
GET /api/Metadata/age-ratings List age ratings · Fetches all age ratings from the instance #
Ask an LLM
“What age ratings are available in my library?”
“Can I get age ratings for one library?”
Tell an agent
List the age ratings.
Show age ratings for libraries {libraryIds}.
GET /api/Metadata/publication-status List publication statuses · Fetches all publication status' from the instance #
Ask an LLM
“What publication statuses exist in my library?”
“Can I get publication statuses for a single library?”
Tell an agent
List the publication statuses.
Show publication statuses for libraries {libraryIds}.
GET /api/Metadata/languages List languages in libraries · Fetches all age languages from the libraries passed (or if none passed, all in… #
Ask an LLM
“Which languages are used in my library?”
“Can I get the languages for one library?”
Tell an agent
List the languages in my library.
Show languages for libraries {libraryIds}.
GET /api/Metadata/all-languages List all languages Kavita accepts · Returns all languages Kavita can accept #
Ask an LLM
“What languages can Kavita accept?”
“Which language codes does Kavita support?”
Tell an agent
List all languages Kavita accepts.
Show every language code Kavita supports.
GET /api/Metadata/all-bcp47-languages List BCP 47 language codes · Returns a list of all BCP47 Languages. `IsoCode` stores the BCP47 code #
Ask an LLM
“What BCP 47 language codes does Kavita accept?”
“Can I get the full language code list?”
Tell an agent
List all BCP 47 languages.
Show the BCP 47 language codes.
GET /api/Metadata/language-title Get a language's display name · Given a language code returns the display name #
Ask an LLM
“What is the display name for a language code?”
“Can I translate a language code to its name?”
Tell an agent
Get the display name for language code {code}.
Translate {code} to its language name.
GET /api/Metadata/series-detail-plus Get series details with Kavita+ data · Fetches the details needed from Kavita+ for Series Detail page #
Ask an LLM
“Can I get the full series details including Kavita+ data?”
“What happens if the series details are older than two weeks?”
Tell an agent
Get series details for series {seriesId}.
Show series {seriesId} details with Kavita+ data.

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