curl --request GET \
--url https://gdeltcloud.com/api/v2/intelligence/gpr \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/intelligence/gpr"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/intelligence/gpr', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"series_id": "atlas.pulse.country.ukr.fullspectrum.all",
"level": "country",
"geo_id": "UKR",
"methodology_version": "atlas-pulse-1.2.0",
"baseline": {
"version": "pulse-2026q3",
"mean_anchor": 100,
"window": [
"2026-01-01",
"2026-06-30"
],
"fixed": true,
"coder_version": "cameoplus-2026-08",
"n_obs": 181,
"base_events": 18240,
"bands_usable": true,
"provisional": false
},
"coverage_floor": 10,
"coverage_floor_basis": "single_day",
"data": [
{
"date": "2026-08-22",
"value": 137.4,
"coverage_events": 91,
"insufficient_data": false
}
],
"pagination": {
"limit": 100,
"cursor": null,
"next_cursor": null
}
}Atlas GPR — geopolitical risk vs a place’s own normal
Vintaged Atlas GPR readings for one explicit geographic level and place. Every accepted query parameter is declared here; undeclared geographic shortcuts such as country= fail with UNKNOWN_PARAM rather than returning the World series. Country own_coverage rows may include a separate best_effort calculation below the daily count floor. The official pulse remains null; the estimate uses the same coder-matched denominator, carries no band or trend claim, and is absent for zero coverage, open UTC days, missing or pooled baselines. world_corpus gates are unchanged.
curl --request GET \
--url https://gdeltcloud.com/api/v2/intelligence/gpr \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/intelligence/gpr"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/intelligence/gpr', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"series_id": "atlas.pulse.country.ukr.fullspectrum.all",
"level": "country",
"geo_id": "UKR",
"methodology_version": "atlas-pulse-1.2.0",
"baseline": {
"version": "pulse-2026q3",
"mean_anchor": 100,
"window": [
"2026-01-01",
"2026-06-30"
],
"fixed": true,
"coder_version": "cameoplus-2026-08",
"n_obs": 181,
"base_events": 18240,
"bands_usable": true,
"provisional": false
},
"coverage_floor": 10,
"coverage_floor_basis": "single_day",
"data": [
{
"date": "2026-08-22",
"value": 137.4,
"coverage_events": 91,
"insufficient_data": false
}
],
"pagination": {
"limit": 100,
"cursor": null,
"next_cursor": null
}
}Authorizations
Query Parameters
Spatial aggregation of the risk series: the world or a selected continent, region or country. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_level
world, continent, region, country Own-coverage series or the count-weighted world-corpus reference. The world-corpus reference uses the gpr variant/metric and attention weighting. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_gpr_construction
own_coverage, world_corpus GPR lens. Defaults to gpr for world_corpus and events otherwise. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_gpr_variant
events, attention, fullspectrum, gpr Component of the selected risk variant used for decomposition; use get_parameter_options with the variant to discover compatible components. The legal values DEPEND ON variant: variant=events → all, threats, acts, verbal, material; variant=attention → all; variant=fullspectrum → all, threats, acts, verbal, material; variant=gpr → all, threats, acts. The enum is the union across every variant. The events lens (and its fullspectrum storage alias) carries all five; the gpr lens is built from the threat/act partition only, so verbal and material do not exist for it; the attention lens is a single undecomposed series, so all is its only component. Measured against prod: 6 of the 15 pairs a flat 5-value enum implies cannot return a row. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_gpr_component
all, threats, acts, verbal, material Measure to read from the returned geopolitical-risk series; select it for the chosen construction and variant. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_gpr_metric
gpr, pulse, attention_share How country observations contribute to the regional or world aggregate; attention weights by coverage, equal gives countries equal weight. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_weighting
attention, gdp Response
The index series, most recent first.

