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 Search API lets you run full-text queries across Kagi News story clusters. Results are ordered by relevance and include the matched story object along with its source category and batch metadata. A companion endpoint returns historical Chaos Index scores — a proprietary measure of global news turbulence — for use in trend analysis or informational dashboards.

​
Endpoints

​
Search stories

Full-text search across story titles, summaries, talking points, quotes, and locations. 
GET /api/search
The /api/search endpoint is a thin proxy to https://kite.kagi.com/api/search. All query parameters are forwarded as-is to the upstream service. Only the q parameter is required; other supported parameters are listed below based on what the upstream API accepts.
You can trigger the search interface directly in the Kagi News UI by pressing / or Cmd+K (Mac) / Ctrl+K (Windows/Linux) from any page.

​
Query parameters

​
q
string
required
Search query string. URL-encode spaces and special characters (e.g. climate+change or climate%20change).
​
lang
string
BCP 47 language code to restrict results to stories in a specific language (e.g. en, es, fr).
​
categoryId
string
Restrict results to a single category by its identifier (e.g. world, technology). Category IDs are available from GET /api/categories/metadata.
​
from
string
ISO 8601 datetime string (e.g. 2024-01-15T00:00:00Z) to filter stories published on or after this date.
​
to
string
ISO 8601 datetime string to filter stories published on or before this date.
​
limit
integer
Maximum number of results to return. Defaults to 100.
​
offset
integer
Zero-based offset for paginating through results. Use in combination with limit.

​
Example request

curl "https://kite.kagi.com/api/search?q=climate+change"

​
Response

The endpoint returns a JSON object with the following fields:
​
results
object[]
required
Array of search result objects, ordered by relevance.
​
hasMore
boolean
required
true when additional results are available beyond the current page. Use offset to retrieve the next page.
​
totalCount
number
required
Total number of stories matching the query across all batches.

​
Example response

{
  "results": [
    {
      "story": {
        "id": "story-xyz789",
        "cluster_number": 3,
        "title": "UN Climate Summit Yields Binding Emission Targets",
        "short_summary": "Delegates at the UN climate conference agreed on legally binding emission reduction targets for 2035, marking a significant shift from voluntary pledges.",
        "category": "Environment",
        "emoji": "🌱",
        "talking_points": [
          "Binding 2035 emission reduction targets agreed",
          "140 countries signed the final declaration"
        ],
        "articles": [
          {
            "title": "UN climate deal reached after marathon talks",
            "link": "https://reuters.com/world/un-climate-deal",
            "domain": "reuters.com",
            "date": "2024-11-20"
          }
        ]
      },
      "categoryId": "world",
      "categoryName": "World",
      "batchId": "550e8400-e29b-41d4-a716-446655440000",
      "batchDate": "2024-11-20T08:00:00Z"
    }
  ],
  "hasMore": false,
  "totalCount": 1
}

​
Get Chaos Index history

Returns a time-series of historical Chaos Index scores. The Chaos Index is a proprietary signal that quantifies the overall turbulence and intensity of the global news cycle on a given day. 
GET /api/chaos/history

​
Query parameters

​
lang
string
BCP 47 language code for the summary text in the response (e.g. en, es). Defaults to English.
​
days
integer
Number of past days to include in the response. Defaults to 30. Use 7 for a weekly view or a larger value for longer trend analysis.

​
Example request

curl "https://kite.kagi.com/api/chaos/history"

​
Response

The endpoint returns a JSON array of daily Chaos Index records, ordered from oldest to most recent.
​
date
string
required
ISO 8601 date string for this data point (e.g. "2024-11-18").
​
score
number
required
Numeric Chaos Index score for the day. Higher values indicate a more turbulent news cycle.
​
summary
string
required
Brief human-readable description of the news conditions on this day, in the requested language.

​
Example response

[
  {
    "date": "2024-11-18",
    "score": 62,
    "summary": "Elevated tensions in Eastern Europe and concurrent financial volatility drove a heightened news cycle."
  },
  {
    "date": "2024-11-19",
    "score": 45,
    "summary": "Markets stabilized and diplomatic talks reduced immediate conflict risks, lowering overall news intensity."
  },
  {
    "date": "2024-11-20",
    "score": 71,
    "summary": "A surprise policy announcement and two regional crises pushed the index to its highest point this month."
  }
]

Build docs developers (and LLMs) love

Get started for freeTalk to us