Data model
Five objects, one graph, every continent.
Objects
| Article | A single item from one source: title, summary, URL, language, published time and classification. |
| Source | A feed or wire: name, feed URL, region, country, language and authority (1 to 5). |
| Event | A cluster of articles covering the same story, with article and source counts and a timeline. |
| Entity | A person, organisation or place with a stable canonical id, linked to the articles and events that mention it. |
| Link | An 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
| id | UUID. |
| source_id | UUID of the originating source. |
| url | Canonical article URL, tracking parameters removed. |
| title | Headline. |
| summary | Feed summary or description. |
| lang | ISO 639-1 language code, detected offline. |
| published_at | ISO 8601 timestamp, UTC. |
| category | Editorial category. |
| domain | Industry domain. |
| region | Source region. |
| country | ISO 3166-1 alpha-2, matched from the text. |
| keywords | Extracted 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