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.