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

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

Own-coverage series or the count-weighted world-corpus reference. The world-corpus reference uses the gpr variant/metric and attention 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_gpr_construction

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

Component of the selected risk variant used for decomposition; use get_parameter_options with the variant to discover compatible components. 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

Measure to read from the returned geopolitical-risk series; select it for the chosen construction and variant. 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

How country observations contribute to the regional or world aggregate; attention weights by coverage, equal gives countries equal weight. 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

Spatial aggregation of the risk series: the world or a selected continent, region or country. 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

Place identifier appropriate for level; required when level is continent, region, or country and omitted for world. 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.

Trailing display window in days (1–30).

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.

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.

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.

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.

Number of records to return on this page; pagination describes how to continue. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Number of records to skip before this page. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.