curl --request GET \
--url https://gdeltcloud.com/api/v2/situations/{story_id}/entities \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/situations/{story_id}/entities"
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}/entities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": []
}List all linked entities in a stored Situation
Paginated canonical entities across full servable stored membership, independently of the detail endpoint’s 40-entity or 200/250-member view. Identity merging precedes type filtering and pagination. summary.entity_count and by_type cover the whole requested scope; pagination.total covers the type filter. Bounded query failure returns an error, never a partial exact total. Shared auth and query quotas apply.
curl --request GET \
--url https://gdeltcloud.com/api/v2/situations/{story_id}/entities \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/situations/{story_id}/entities"
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}/entities', 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.
Case-insensitive entity kind from summary.by_type. unknown selects untyped records; filtering happens after identity folding. 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 <= 200Number of records to skip before this page.
x >= 0