A geo-scoped geopolitical-risk index normalized to each place’s own FROZEN baseline: 100 = normal for that place, 200 = twice its usual. Places are measured against themselves, never against a leaderboard, so the index is not a restatement of which countries generate the most news.
Two parallel constructions, selected with construction and named by their denominator (not v1/v2 — this endpoint is already API v2):
own_coverage (default) — the place’s qualifying share of its OWN coded-event coverage, measured on a single day.world_corpus — the place’s share of ALL coded events worldwide over a 14-day window. This is the construction the Caldara–Iacoviello GPR and the Fed’s country-level GPRC use. Fourteen days is two whole weeks, so the corpus’s weekday cycle cancels by construction.Nothing is fabricated. Below the evidence floor a reading is null with insufficient_data: true and a reason — never 0. A band is withheld (with band_status) whenever the frozen ladder cannot keep its frequency promise. A coder-model change is an instrument change: baselines are frozen per generation, every reading is normalized against its own, and baseline_coder_version names it.
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Which construction. Named by the DENOMINATOR. world_corpus is the field’s reference GPR and the right choice for cross-country comparison or for anything you will difference or correlate.
own_coverage, world_corpus Which substrate. events = tension computed from coded events. attention = the event-INDEPENDENT share of news attention on tension-bearing narratives. They can disagree, and the disagreement is often the signal.
events, attention Decompose into a CAMEO-family sub-stream. Validated PER LENS: the attention lens publishes only all, and the GPR lens has no verbal/material. An unsupported pair returns 400 INVALID_ENUM listing what that lens does have.
all, threats, acts, verbal, material Which series to return.
gpr, attention_share Roll-up weighting for aggregate geographies. gdp is EPU-style and does not apply to a country (a country is not a roll-up).
attention, gdp Geographic resolution. world needs no geo; every other level requires one.
world, continent, region, country The place, when level is continent/region/country: an ISO-3166 alpha-3 code, or a region / continent name. An unknown value returns 400 INVALID_ENUM listing what that level accepts.
Trailing days of the series to return. Not the measurement window.
1 <= x <= 370Explicit series start (overrides window).
Explicit series end.
A single observation date instead of a range.
Point-in-time read: reproduce the index as it was KNOWN on this date, with no look-ahead.
Page size.
1 <= x <= 370The index series, most recent first.
true "atlas.pulse.country.ukr.fullspectrum.all"
"atlas-pulse-1.2.0"
Present only on construction=world_corpus, describing the formula in force.
The frozen reference the returned rows were measured against.
"single_day"