Skip to main content
GET
Get Story Articles

Authorizations

Authorization
string
header
required

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

Path Parameters

story_id
string
required

The story id.

Query Parameters

start_date
string<date>

First Story partition date. date_start is an alias. Also accepts: date_start. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

end_date
string<date>

Last Story partition date. date_end is an alias. Also accepts: 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.

date
string<date>

Single Story partition 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
default:14

Trailing date window. window is an alias. 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:25

Maximum articles 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 <= 100
cursor
string

Pagination 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. 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
include_images
boolean

Attach resolved article images. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

language
string

Origin language filter. languages is an alias. Also accepts: languages. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

publisher_country_iso3
string

Known publisher-country filter. publisher_country is an alias; unknown publishers are never guessed. Also accepts: publisher_country. 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

200 - application/json

Paginated source articles

success
enum<boolean>
Available options:
true
pagination
object
data
object[]