Skip to main content
GET
List a Situation's stories

Authorizations

Authorization
string
header
required

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

Path Parameters

story_id
string
required

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.

Query Parameters

scope_version
string

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.

date_start
string<date>

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.

date_end
string<date>

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.

limit
integer
default:25

Records per page; independent of graph limits. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Required range: 1 <= x <= 100
offset
integer
default:0

Records to skip in this list. Stories order by reporting date, article count, ID; Events by significance then ID.

Required range: x >= 0

Response

Success

success
boolean
data
object[]