Endpoints

Seven read-only endpoints. All return JSON, and all require X-API-Key except /v1/health.

GET/v1/health

Liveness probe. No authentication.

{"status":"ok","service":"kontextnews","version":"1.0.0"}

GET/v1/stats

Aggregated corpus stats: sources, articles, events, entities, languages and per-region coverage.

{
  "sources": 265, "articles": 4884, "events": 82, "entities": 14818, "languages": 31,
  "by_region": [
    {"region":"europe","sources":49,"articles":979},
    {"region":"north_america","sources":31,"articles":581}
  ]
}

GET/v1/articles

List articles, newest first.

category	Filter by category.
domain	Filter by domain.
region	Filter by region.
lang	Filter by language.
since	ISO 8601; articles at or after.
limit	1 to 200, default 50.
offset	Pagination offset, default 0.

curl "https://api.kontextnews.online/v1/articles?category=ai&limit=2" \
  -H "X-API-Key: kn_live_..."

GET/v1/articles/{id}

One article with its sources, entities and events.

{
  "id": "5877259d-f521-4b08-b362-b4e2dd1209aa",
  "title": "...",
  "sources":  [{"name":"Techmeme","feed_url":"...","is_primary":true}],
  "entities": [{"type":"org","name":"OpenAI","canonical":"openai"}],
  "events":   [{"event_id":"...","title":"..."}]
}

GET/v1/events

Cross-source events, ordered by source count.

category	Filter by category.
region	Filter by region.
limit	1 to 200, default 50.
offset	Pagination offset.

{
  "id": "a61f1d35-30e0-4a90-b3e9-ad1ffc68a61d",
  "title": "Daniil Medvedev disqualified from China Open after hitting spectator in face with ball",
  "article_count": 4,
  "source_count": 4,
  "score": 4.0,
  "status": "open",
  "first_seen": "2026-10-05T16:13:32+00:00",
  "last_seen": "2026-10-05T19:42:28+00:00"
}

GET/v1/events/{id}

One event with its member articles.

{
  "id": "...", "title": "...",
  "articles": [{"id":"...","title":"...","url":"...","source_id":"...","published_at":"..."}]
}

GET/v1/sources

The source registry, ordered by authority.

region	Filter by region.
include_disabled	Include disabled feeds, default false.

curl "https://api.kontextnews.online/v1/sources?region=europe" \
  -H "X-API-Key: kn_live_..."

GET/v1/search

Hybrid full-text and fuzzy search. See Search & ranking.