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 Kagi News (Kite) front-end exposes a REST API that proxies directly to https://kite.kagi.com/api. Every request your application makes to a self-hosted Kite instance is transparently forwarded to the upstream service, so you can use either the canonical base URL or the URL of your own deployment interchangeably.

​
Base URL

https://kite.kagi.com/api
All endpoints below are relative to this base. If you are running a self-hosted instance, substitute your instance’s origin for https://kite.kagi.com.

​
Authentication

Most endpoints are public and require no credentials. Sync endpoints (/api/sync/*) manage per-user reading history and require an active Kagi account session cookie to be present in the request.

​
Response Format

All endpoints return JSON. Successful responses carry an HTTP 200 status. Proxy errors (e.g. the upstream service is unreachable) return HTTP 500 with the body: 
{ "error": "Proxy request failed" }

​
Entry Point

The root data file for a Kite deployment is available at: 
curl https://kite.kagi.com/kite.json
This JSON file lists the current batch’s categories and top-level metadata, and is a useful starting point for discovering available content before querying individual API endpoints.

​
Quick Start

Fetch the latest batch metadata with a single curl command — no API key required: 
curl https://kite.kagi.com/api/batches/latest

​
Data License

All content returned by this API is published under the Creative Commons Attribution-NonCommercial (CC BY-NC) license. You are free to use, share, and adapt the data for non-commercial purposes, provided you give appropriate credit to Kagi News.
Commercial use is not permitted under the CC BY-NC license. If you intend to use Kagi News data in a commercial product or service, contact support@kagi.com to discuss licensing options.

​
Available Endpoint Groups

Batches

List published news batches, retrieve batch metadata, available languages, the Chaos Index score, and On This Day events.Prefix: /api/batches

Categories

Access category metadata and listing across batches.Prefix: /api/categories

Stories

Fetch the full story clusters for a given batch and category, including summaries, perspectives, timelines, and source articles.Prefix: /api/batches/{batchId}/categories/{categoryId}/stories

Search

Search across published stories and articles.Prefix: /api/search

Sync

Read-history synchronisation for authenticated Kagi users. Requires a valid Kagi session cookie.Prefix: /api/sync

Widgets

Live data widgets — weather, cryptocurrency prices, F1, NFL, and NHL scores and standings.Prefix: /api/widgets

Build docs developers (and LLMs) love

Get started for freeTalk to us