Divergence API

Querying the API with an LLM? Click here!

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. Pro extends history to 30 days, and Max reaches the full archive. All tiers get every event-level endpoint; market endpoints remain Max-only. 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.
• Market - article-level market desk feed and tag aggregates (Max tier).

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.