Docs  /  Introduction

Introduction

Divergence tracks 45 news outlets across the political spectrum, clusters their coverage into shared events, and scores how much the outlets disagree about each one. Updated every 30 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
  • Article-level market desk feed with ~720 ticker tags and 47 topic tags (Max tier)

The last 7 days is free and public, with no key required. Pro keys reach 30 days, and Max keys reach the full archive. 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.
  • 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.