curl --request GET \
--url https://gdeltcloud.com/api/v2/situations/{story_id}/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/situations/{story_id}/events"
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}/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": []
}List a Situation's events
Independently paginated events over current servable membership. Summary and pagination totals cover all matching members, never a graph sample. Article counts sum member Story counts, not unique URLs. Date filters select member reporting dates; Event occurrence dates remain separate. Event facts are hydrated from serving_events, while serving_event_story_links supplies membership only. incident_relations contains accepted directional umbrella/component links whose two endpoints are on this returned page; nullable summary counts distinguish unavailable or incomplete publication from a measured zero.
curl --request GET \
--url https://gdeltcloud.com/api/v2/situations/{story_id}/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/situations/{story_id}/events"
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}/events', 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$Optional version from the preceding page scope. A changed scope returns 409 instead of silently mixing pages. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Optional earliest member reporting date. Omit both dates for the full servable membership. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Optional latest member reporting date. No implicit first200-member truncation. 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.
1 <= x <= 100Number of records to skip before this page.
x >= 0Up to eight comma-separated retained Event UIDs. Returns complete frozen records in edition order. Offset and limit paginate that selected set. Requires one of edition_id or as_of. The selected records stay frozen only inside one retained edition. Cannot be combined with date_start or date_end. 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
Success
true Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes