Skip to main content
GET
/
api
/
v2
/
stories
/
{story_id}
/
articles
cURL
curl "https://gdeltcloud.com/api/v2/stories/story_123/articles" \
  -H "Authorization: Bearer $GDELT_CLOUD_API_KEY"
{
  "success": true,
  "data": [
    {
      "url": "https://www.example.com/data-center",
      "title": "New data center project announced",
      "domain": "example.com",
      "rank": 1
    }
  ],
  "pagination": {
    "limit": 25,
    "cursor": null,
    "next_cursor": "eyJvZmZzZXQiOjI1fQ=="
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Path Parameters

story_id
string
required

Story ID returned by Search Stories, Get Story, or an Event's story_refs.

Query Parameters

limit
integer
default:25

Number of records to return.

Required range: 1 <= x <= 100
Example:

25

cursor
string

Pagination cursor from pagination.next_cursor.

Response

200 - application/json

Paginated source articles

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