Skip to content
Nupdate

API

API information

The public read API behind this site. Responses are JSON, validated against shared schemas, and cacheable.

Endpoints

GET /api/v1/statistics/overview
Headline counts for the home page.
GET /api/v1/statistics/timeline
Article counts per day or week. Params: interval, country, topic, signal, organisation, from, to.
GET /api/v1/weekly/{iso_year}/{iso_week}
Weekly briefing data.
GET /api/v1/articles
Newest-first articles with cursor pagination (next_cursor). Params: q, from, to, country, region, topic, organisation, project, source, signal, event, min_confidence, limit, cursor.
GET /api/v1/countries
List monitored countries.
GET /api/v1/countries/{code}
Country summary: trend, top topics, organisations, latest articles.
GET /api/v1/globe
One point per monitored country for the world map.
GET /api/v1/search
Relevance-ranked full-text search. Params: q, country, topic, signal, from, to, limit.
POST /api/v1/ai/chat
Transient AI proxy (bring your own key in the X-Provider-Key header; never stored).

Example

curl "/api/v1/articles?country=PL&topic=small-modular-reactors&limit=5"

Notes

  • Public endpoints need no authentication and send cache headers.
  • The full OpenAPI description is at /api/v1/openapi.json.
  • A hosted AI endpoint is planned as a paid feature. It is not available yet.