Divergence

Shortcuts over /events that answer the questions Divergence exists to answer.

Most contested right now

GET /api/v2/divergence/top

curl "https://divergence.news/api/v2/divergence/top?limit=5"

Equivalent to /events?sort=divergence&since=now-7d&limit=5&embed=sources. Use this when you want the homepage "most contested" rail and do not want to reason about time math.

By category

GET /api/v2/divergence/{category}

curl "https://divergence.news/api/v2/divergence/economy?limit=10"

Equivalent to /events?category={category}&sort=divergence. Categories: war, economy, politics, ai, health, other.

Coverage gaps

GET /api/v2/divergence/gaps

curl https://divergence.news/api/v2/divergence/gaps

Returns events where one side of the spectrum covered the story and the other did not. Useful for finding stories your default news diet is hiding.

Response

{
  "data": [
    {
      "id": 14781,
      "title": "DOJ antitrust suit against three grocery chains moves to discovery",
      "category": "economy",
      "divergence_score": 52,
      "article_count": 5,
      "time_ago": "9h ago",
      "updated_at": "2026-04-18T09:15:00Z",
      "gap": {
        "covered_by": "left",
        "ignored_by": "right",
        "covered_count": 5,
        "ignored_count": 0
      }
    }
  ],
  "meta": { "count": 12, "has_more": false, "next_cursor": null }
}

How "left" and "right" are defined

• left = outlets with bias_position <= 35
• right = outlets with bias_position >= 65
• Center-leaning outlets (36..64) do not count for either side in this endpoint. They are not neutral on every story, but they do not define the gap.

An event qualifies as a gap when one side has 3+ outlets covering it and the other side has 0.