Skip to main content
GET
Atlas GPR — geopolitical risk vs a place’s own normal

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

construction
enum<string>
default:own_coverage

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.

Available options:
own_coverage,
world_corpus
variant
enum<string>
default:events

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.

Available options:
events,
attention
component
enum<string>
default:all

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.

Available options:
all,
threats,
acts,
verbal,
material
metric
enum<string>
default:gpr

Which series to return.

Available options:
gpr,
attention_share
weighting
enum<string>
default:attention

Roll-up weighting for aggregate geographies. gdp is EPU-style and does not apply to a country (a country is not a roll-up).

Available options:
attention,
gdp
level
enum<string>
default:world

Geographic resolution. world needs no geo; every other level requires one.

Available options:
world,
continent,
region,
country
geo
string

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.

window
integer
default:7

Trailing days of the series to return. Not the measurement window.

Required range: 1 <= x <= 370
date_start
string<date>

Explicit series start (overrides window).

date_end
string<date>

Explicit series end.

date
string<date>

A single observation date instead of a range.

as_of
string<date>

Point-in-time read: reproduce the index as it was KNOWN on this date, with no look-ahead.

limit
integer
default:100

Page size.

Required range: 1 <= x <= 370

Response

The index series, most recent first.

success
enum<boolean>
Available options:
true
series_id
string
Example:

"atlas.pulse.country.ukr.fullspectrum.all"

level
string
geo_id
string
methodology_version
string
Example:

"atlas-pulse-1.2.0"

construction
object | null

Present only on construction=world_corpus, describing the formula in force.

baseline
object | null

The frozen reference the returned rows were measured against.

coverage_floor
number
coverage_floor_basis
string
Example:

"single_day"

data
object[]
pagination
object