Skip to main content
GET
List change feed

Authorizations

Authorization
string
header
required

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

Query Parameters

list
enum<string>

Restrict the feed to one list. source is an alias. Case-insensitive. The accepted set grows as sources are ingested: the values published here are the snapshot at build time, and /api/v2/lists (rows with ingested: true) is the live list. Also accepts: source. 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#list_source_key

Available options:
csl_ofac_sdn,
csl_ofac_ssi,
csl_ofac_cmic,
csl_ofac_nsmbs,
csl_ofac_capta,
csl_bis_entity,
csl_bis_meu,
csl_bis_uvl,
csl_bis_dpl,
csl_state_debarred,
csl_state_isn,
dod_1260h,
un_consolidated,
uk_uksl
change_type
enum<string>

added, removed or changed. Full value list: https://docs.gdeltcloud.com/reference/enums#list_change_type

Available options:
added,
removed,
changed
date
string<date>

One snapshot date; with days it ends the trailing span on that date. 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>

First snapshot date of an explicit window. start_date is an alias. Also accepts: start_date. 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>

Last snapshot date of an explicit window. end_date is an alias. Also accepts: end_date. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

days
string

Trailing window in snapshot days, 1–30. window is an alias; 7 and 7d are both accepted. Also accepts: window. 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:50

Maximum change rows returned. 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 <= 200
cursor
string

Pagination cursor from pagination.next_cursor. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

offset
integer

Legacy numeric offset; cursor is preferred. 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: x >= 0

Response

List change feed.

success
boolean
required
data
object[]
required
pagination
object
required
applied_filters
any
required