KontextNews API

One engine for the world's news: top sources from every continent, structured into events and entities, de-duplicated, scored, and served as JSON to developers and AI agents.

QuickstartMake your first request in a minute. EndpointsSeven read-only endpoints, one schema. Search & rankingHybrid full-text and fuzzy search, freshness-weighted. Data modelArticles, events, entities and sources.

Base URL

https://api.kontextnews.online

All endpoints live under /v1 and return JSON. Every request except /v1/health requires an API key.

What you get

Structured articles: title, summary, URL, language, published time, category, domain, region, country and keywords.
Events: the same story from many outlets, collapsed into one event with the source count.
Entities and relations: people, organisations and places with stable identifiers.
Hybrid search: PostgreSQL full-text plus trigram similarity, ranked with a recency decay.

Example

curl "https://api.kontextnews.online/v1/search?q=Nvidia&limit=2" \
  -H "X-API-Key: kn_live_..."

[
  {
    "id": "5877259d-f521-4b08-b362-b4e2dd1209aa",
    "title": "Sources: Nico Caprez, son-in-law to Jensen Huang, rapidly ascended to become an Nvidia VP",
    "url": "https://www.techmeme.com/261005/p19#a261005p19",
    "published_at": "2026-10-05T13:55:03+00:00",
    "category": "tech",
    "domain": "chips",
    "region": "global",
    "lang": "en",
    "rank": 0.696
  }
]