Stories API vs. News APIs

Clustered Stories, not raw articles

Most news APIs hand you a stream of raw articles to dedupe and structure yourself. GDELT Cloud's Stories API clusters articles from many sources into a single deduplicated Story — with a generated summary, an article count, ranked top sources, linked structured Events, and Wikipedia-resolved entities — over a REST API and MCP.

Highlight

Each Story is a cross-source cluster of articles with a generated summary and article count.

Highlight

Ranked top sources per Story (URL, title, domain) — plus the structured Events it links to.

Highlight

Wikipedia-resolved entities and plain-English geography attached to every Story.

Highlight

Query /api/v2/stories over REST or MCP; filter by geography, category, and significance.

How our Stories API differs

 GDELT Cloud Stories APITypical news APIs
Core objectStory = cross-source cluster of articlesIndividual articles
Per resultSummary, article count, ranked top sourcesPer-article metadata
DeduplicationClustered into one Story across sourcesPer-article; you dedupe (some cluster)
Linked structureLinked structured Events on each Story
EntitiesWikipedia-resolved, attached to the StoryNER / keyword tags (varies)
Geography & rankingGeocoded + significance rankingSource country / recency (varies)
AccessREST /api/v2/stories + MCPREST (varies)
Pricing modelFree tier → self-serve plansPer-request tiers; NLP/event tiers contact-sales

GDELT Cloud at scale

Every day, GDELT Cloud clusters a continuous, multi-source raw-article stream into tens of thousands of Stories, codes structured CAMEO+/ACLED Events, and resolves Wikipedia-linked Entities — refreshed hourly, around the clock. These Events, Stories, and Entities are data we produce, not redistribute.

And it's more than events: the API, MCP server, and Briefs also draw on a growing set of data sources — financial markets, macroeconomic indicators, prediction markets, web research, and Global Energy Monitor energy-infrastructure data.

Tens of thousands
Stories clustered / day
Hourly
Continuous ingest, 24/7
10 + ACLED
CAMEO+ domains + conflict coding
Wikipedia
Entities resolved & linked
See live hourly & daily volumes on Data Status →

Price & fit

Capable news APIs run from a few hundred to several thousand dollars a month, and the richest event/NLP tiers are gated behind sales. GDELT Cloud is self-serve — a free tier, with paid plans from $49 to $1,499/mo.

Who it's for

Developers, analysts, and small media-monitoring or research teams who want structured, deduplicated Stories — not a raw article stream — without an enterprise contract.

Even at enterprise scale

Use GDELT Cloud as an affordable structured-events layer alongside a raw news feed — clustered Stories and coded Events at a fraction of a premium news-intelligence contract.

Start with the free tier

Structured global events, stories, entities, and energy data over a REST API and MCP — self-serve, no enterprise contract.