Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/kagisearch/kite-public/llms.txt

Use this file to discover all available pages before exploring further.

The Categories API returns metadata for every category known to Kagi News (Kite). Each category record carries a stable identifier, a canonical name, an optional localized display name, and the list of RSS/Atom feeds that populate it. This endpoint is useful for building navigation menus, populating filter lists, or discovering which categories exist before fetching stories.

​
Endpoints

​
Get all category metadata

Returns metadata for all known categories. Pass a lang query parameter to receive a localized display_name for each category. 
GET /api/categories/metadata
To list only the categories present in a specific batch (along with per-category story counts), use GET /api/batches/{batchId}/categories instead. See the Batches API for details.

​
Query parameters

​
lang
string
BCP 47 language code (e.g. en, es, fr, de) used to localize display_name. When omitted, the server returns the default English label.

​
Example request

curl "https://kite.kagi.com/api/categories/metadata"

​
Example response

[
  {
    "id": "world",
    "name": "World",
    "display_name": "World News",
    "feeds": [
      "https://feeds.bbci.co.uk/news/world/rss.xml",
      "https://rss.nytimes.com/services/xml/rss/nyt/World.xml"
    ]
  },
  {
    "id": "technology",
    "name": "Technology",
    "display_name": "Technology",
    "feeds": [
      "https://feeds.arstechnica.com/arstechnica/technology-lab",
      "https://www.wired.com/feed/rss"
    ]
  }
]

​
Response fields

The endpoint returns a JSON array. Each element is a Category object:
​
id
string
required
Stable, URL-safe category identifier (e.g. "world", "technology"). Use this value as categoryId in the Stories and Batches endpoints.
​
name
string
required
Canonical English name for the category.
​
display_name
string
Localized display label. Present when a lang parameter is supplied and a translation exists; otherwise may be omitted or equal to name.
​
feeds
string[]
Array of feed URLs that supply articles for this category. May be omitted when the server omits feed-level detail from the response.

Build docs developers (and LLMs) love

Get started for freeTalk to us