Events

The primary resource. An event is a real-world happening the system identified by clustering articles from the 27 tracked outlets.

List events

GET /api/v2/events

curl "https://divergence.news/api/v2/events?category=economy&min_divergence=50&limit=10"

Response

{
  "data": [
    {
      "id": 14782,
      "title": "Senate passes sweeping immigration bill amid partisan divide",
      "summary": "The Senate passed a sweeping immigration reform bill along party lines, prompting immediate legal challenges...",
      "category": "economy",
      "divergence_score": 74,
      "article_count": 9,
      "time_ago": "4h ago",
      "reported_at": "2026-04-18T10:00:00Z",
      "updated_at": "2026-04-18T14:02:00Z"
    }
  ],
  "meta": { "count": 10, "has_more": true, "next_cursor": "eyJ..." }
}

Parameters

Name	Type	Default	Notes
`cursor`	string	-	From previous page's `meta.next_cursor`
`limit`	int	25	1 to 100
`category`	enum	-	`war`, `economy`, `politics`, `ai`, `health`, `other`
`min_divergence`	int	-	0 to 100
`max_divergence`	int	-	0 to 100
`outlet`	string	-	Repeatable. Outlet slug
`framing`	enum	-	See Framing labels
`min_sentiment`	float	-	-1 to +1
`max_sentiment`	float	-	-1 to +1
`since`	ISO 8601	-	Bounds `first_seen_at`
`until`	ISO 8601	-	Bounds `first_seen_at`
`sort`	enum	`divergence`	`divergence`, `recent`, `covered`
`embed`	string	-	Comma-separated: `sources`, `facts`

Get an event

GET /api/v2/events/{id}

curl https://divergence.news/api/v2/events/14782

Always returns sources and facts inline. The embed parameter is ignored here.

Response

{
  "data": {
    "id": 14782,
    "title": "Fed holds rates at 5.25-5.50%, signals possible cut by July",
    "summary": "The Federal Reserve kept its benchmark rate unchanged...",
    "category": "economy",
    "divergence_score": 74,
    "article_count": 9,
    "time_ago": "4h ago",
    "reported_at": "2026-04-18T10:00:00Z",
    "updated_at": "2026-04-18T14:02:00Z",
    "sources": [
      {
        "outlet": "Fox News",
        "outlet_slug": "fox-news",
        "domain": "foxnews.com",
        "bias": "right",
        "bias_position": 82,
        "framing": "critical",
        "framing_label": "Critical of Fed",
        "framing_summary": "Treats the pause as evidence the Fed has lost the inflation fight; leads with gas and grocery prices.",
        "headline": "Powell stalls as families drown in Biden-era prices",
        "byline": "Jordan Reeve",
        "sentiment": -0.42,
        "url": "https://foxnews.com/...",
        "published_at": "2026-04-18T11:15:00Z"
      }
    ],
    "facts": [
      {
        "status": "confirmed",
        "text": "The bill passed 53-47 along party lines.",
        "source_attribution": "Senate vote record",
        "count": "9/9"
      },
      {
        "status": "disputed",
        "text": "Whether the bill's asylum provisions violate existing treaty obligations.",
        "source_attribution": "ACLU statement, Apr 18 2026",
        "count": "4/9"
      }
    ]
  }
}

Errors

404 not_found - event does not exist or has been removed
401 archive_token_required - event is older than your tier's lookback window (7 days for free/pro, 90 for dev)
401 invalid_api_key - the supplied key is unrecognized or revoked