curl --request GET \
--url https://gdeltcloud.com/api/v2/situations/{story_id}/brief \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/situations/{story_id}/brief"
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/situations/{story_id}/brief', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {}
}Read a retained Situation brief
Edition-bound as-of explanation, salient Events and actors, supported relationships, time-step traversal, full-scope statistics, frozen citations, previews and detail links. New editions do not forecast. Structure adds typed graph nodes and edges; context adds source-gated existing context. No model calls occur during reads. Unavailable analysis remains explicit: meta.analysis_wait says why there is none (evidence_floor with holds and needs, in_preparation, or check_failed) and next_check gives the UTC time of the next run that can change it; it is null when an analysis is served.
curl --request GET \
--url https://gdeltcloud.com/api/v2/situations/{story_id}/brief \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/situations/{story_id}/brief"
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/situations/{story_id}/brief', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
A stored Situation UID (sit_…). Published as story_id for path compatibility with /api/v2/situations/{story_id}, which accepts either; the member lists accept only the UID — a Story id is refused.
^sit_[A-Za-z0-9_-]{1,124}$Query Parameters
Retained edition identifier from get_situation_editions. Pins the published snapshot. Cannot be combined with as_of. Select one edition. Requires the {story_id} path segment to match ^sit_[A-Za-z0-9_-]{1,124}$. Retained editions exist only for a stored Situation UID.
^sed_[a-f0-9]{32}$Latest edition published at or before this UTC ISO timestamp. No reconstruction before retention began. Cannot be combined with edition_id. Select one edition. Requires the {story_id} path segment to match ^sit_[A-Za-z0-9_-]{1,124}$. Retained editions exist only for a stored Situation UID.
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$Progressive detail level: brief (default), structure, context. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.