KontextNews

Data model

Five objects, one graph, every continent.

Objects

ArticleA single item from one source: title, summary, URL, language, published time and classification.
SourceA feed or wire: name, feed URL, region, country, language and authority (1 to 5).
EventA cluster of articles covering the same story, with article and source counts and a timeline.
EntityA person, organisation or place with a stable canonical id, linked to the articles and events that mention it.
LinkAn edge: article to source, article to entity, event to entity, or entity to co-occurring entity.

Relationships (the graph)

Articles link to their source, to the entities they mention, and to the event they belong to. Entities link to the events they appear in and to the entities they co-occur with on the same article. This is what makes the API intelligence rather than a list: from an entity you can reach its articles, its events and its co-occurring entities; from an event you can reach its articles, its entities and related events that share entities.

article --source--> source
article --mentions--> entity        (salience)
event   --contains--> article       (is_primary)
event   --involves--> entity        (salience)
entity  --co-occurs--> entity       (shared articles)

Event timeline and cross-source consensus

/v1/events/{id} returns a timeline: the event's articles ordered in time, each with its source. Combined with article_count and source_count, that is the cross-source picture: how many independent outlets reported it and in what order. No LLM is involved; it is deterministic.

Article fields

idUUID.
source_idUUID of the originating source.
urlCanonical article URL, tracking parameters removed.
titleHeadline.
summaryFeed summary or description.
langISO 639-1 language code, detected offline.
published_atISO 8601 timestamp, UTC.
categoryEditorial category.
domainIndustry domain.
regionSource region.
countryISO 3166-1 alpha-2, matched from the text.
keywordsExtracted key phrases.

Categories

ai, analysis, business, climate, conflict, culture,
dev, general, health, investigation, justice,
migration, politics, science, sport, tech

Domains

ai, chips, fintech, crypto, energy, auto, pharma, defence,
telecom, space, media, aviation, shipping, retail, gaming, news

Regions

europe, north_america, south_america, asia, africa,
middle_east, oceania, global