Skip to main content
GET
Atlas Posture — country condition and annual context

Authorizations

Authorization
string
header
required

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

Query Parameters

country
string

Country ISO3 shortcut. Takes precedence over geo. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

level
enum<string>
default:country

Geographic level. Defaults to 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

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

Country ISO3, region or continent name. Required unless country is supplied or level=world. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

scope
enum<string>
default:all

Optional dynamic evidence scope. Omission returns all scopes. 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_posture_scope

Available options:
all,
internal,
external
window
enum<string>
default:30d

Measurement window for the dynamic posture axis. Accepted values: 7d, 30d.

Available options:
7d,
30d
weighting
enum<string>
default:attention

Aggregate weighting. A country is not a rollup; response discloses any fallback. 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
date
string<date>

Window end date. Omission uses the latest computed observations. 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>

Observation vintage cutoff. Structural inputs and normalization are not a historical snapshot; inspect response limitations. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Response

Posture score, pillars, and trend.

The response is of type object.