Docs  /  Introduction

Introduction

Divergence tracks 27 news outlets across the political spectrum, clusters their coverage into shared events, and scores how much the outlets disagree about each one. Updated every 10 minutes.

The API gives you structured, citeable access to the same data the site displays:

  • Events and the outlets that covered them
  • Per-article framing, bias position, sentiment, and byline
  • Divergence scores and the plain-language readout behind each one
  • Aggregate stats and timeseries by category
  • Outlet-level metadata and coverage history
  • Coverage gaps: stories covered by one side of the spectrum and ignored by the other

The last 7 days is free and public, with no key required. Data older than 7 days needs a Dev-tier key (90-day window). See authentication for tiers and limits.

Base URL

https://divergence.news/api/v2

What this is not

  • Not a news reader. You can build one on top of it, but the API returns facts about coverage, not curated feeds.
  • Not a real-time firehose. Ingest runs every 10 minutes. Webhooks are on the roadmap, not shipped.
  • Not a scoring opinion service. Divergence is computed from article content and attribution, not editorial judgment.

Status

Version 2.0. Production. Stable. Breaking changes ship behind a new /api/v3 path.