Atlas GPR — geopolitical risk vs a place’s own normal

curl --request GET \
  --url https://gdeltcloud.com/api/v2/intelligence/gpr \
  --header 'Authorization: Bearer <token>'

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 Intelligence

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.

GET

api

intelligence

gpr

Atlas GPR — geopolitical risk vs a place’s own normal

curl --request GET \
  --url https://gdeltcloud.com/api/v2/intelligence/gpr \
  --header 'Authorization: Bearer <token>'

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

Authorization

string

header

required

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

Query Parameters

construction

enum<string>

default:own_coverage

Index construction. world_corpus is the count-weighted GPR reference and accepts only variant=gpr, metric=gpr, and weighting=attention. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_gpr_construction

Available options:

own_coverage,

world_corpus

variant

enum<string>

GPR lens. lens is the legacy alias. Defaults to gpr for world_corpus and events otherwise. Also accepts: lens. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_gpr_variant

Available options:

events,

attention,

fullspectrum,

gpr

component

enum<string>

default:all

Variant-scoped decomposition component. decompose is the legacy alias. Also accepts: decompose. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. 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

Available options:

all,

threats,

acts,

verbal,

material

metric

enum<string>

default:gpr

Returned GPR measure. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_gpr_metric

Available options:

gpr,

pulse,

attention_share

weighting

enum<string>

default:attention

Aggregate weighting. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_weighting

Available options:

attention,

gdp

level

enum<string>

default:world

Geographic aggregation level. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#atlas_level

Available options:

world,

continent,

region,

country

geo

string

Place identifier appropriate for level; id is the legacy alias. Also accepts: id. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

window

integer

default:7

Trailing display window in days (1–30).

Required range: 1 <= x <= 30

date_start

string<date>

First observation date. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

date_end

string<date>

Last observation date. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

date

string<date>

One observation date; overrides the range. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

as_of

string<date>

Point-in-time vintage. realtime_start and vintage are aliases. Also accepts: realtime_start, vintage. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

limit

integer

default:100

Maximum observations returned. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Required range: 1 <= x <= 100

cursor

string

Pagination cursor. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

offset

integer

Legacy numeric pagination offset. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Required range: x >= 0

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.

Show child attributes

baseline

object | null

The frozen reference the returned rows were measured against.

Show child attributes

coverage_floor

number

coverage_floor_basis

string

Example:

"single_day"

data

object[]

Show child attributes

pagination

object

Show child attributes

Events

Stories

Situations

Entities

Unified Search

Media Intelligence

Facilities

Monitors

Geography

Government

Political Offices

Filings

Reference Data

Energy

AI Compute

Macro Finance

Screening and Reference

China

Maritime

Atlas Intelligence

Briefs

Meta

Atlas GPR — geopolitical risk vs a place’s own normal

Authorizations

Query Parameters

Response