Divergence API

A JSON API for cross-spectrum news event data. Built for journalism, research, and anyone who wants to track how stories are framed across the political spectrum.

The API surfaces the same clustered events you see on the site: divergence scores, per-outlet framings, source sentiment, coverage bars, and takeaway summaries. Everything is REST, JSON, and public-by-default for the last 7 days. The Dev tier extends history to 90 days. All tiers get every endpoint; the only differences are the daily request cap and the lookback window. See authentication for tiers and limits.

Start here

• Introduction - what Divergence is and what the API exposes.
• Getting started - first request in under a minute.
• Authentication - when you need a token and how to request one.

Endpoints

• Events - list and inspect clustered events.
• Outlets - per-outlet stats and activity.
• Stats - global snapshots and timeseries.
• Divergence - contested-coverage endpoints: gaps, spectrum, category filters.
• Search - keyword search across events.

Conventions

• Pagination - cursor model.
• Filtering - every filter on every list endpoint.
• Errors - error envelope and status codes.
• Rate limits - limits and headers.

Concepts

• Divergence score - how the score is computed.
• Framing labels - the six framing tags explained.
• Bias positions - where outlets sit on the spectrum.