Skip to main content
GET
/
api
/
v2
/
stories
/
{story_id}
cURL
curl "https://gdeltcloud.com/api/v2/stories/story_123" \
  -H "Authorization: Bearer $GDELT_CLOUD_API_KEY"
{
  "success": true,
  "data": {
    "id": "story_123",
    "url": "https://gdeltcloud.com/story/example-story",
    "title": "Data center projects in Asia",
    "story_date": "2026-04-15",
    "category": "infrastructure",
    "subcategory": null,
    "geo": {
      "country": "Japan",
      "region": "Eastern Asia",
      "continent": "Asia",
      "admin1": "Tokyo",
      "location": "Tokyo",
      "latitude": 35.6762,
      "longitude": 139.6503
    },
    "metrics": {
      "significance": 0.82,
      "article_count": 12,
      "linked_event_count": 2,
      "max_linked_event_significance": 0.71
    },
    "has_events": true,
    "has_fatalities": false,
    "fatalities": 0,
    "linked_events": [
      {
        "id": "cameoplus_abc123",
        "title": "Infrastructure investment announced"
      }
    ],
    "entity_refs": [],
    "top_articles": [
      {
        "url": "https://www.example.com/data-center",
        "title": "New data center project announced",
        "domain": "example.com",
        "rank": 1
      }
    ]
  }
}

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 or linked from an Event.

Response

Story detail

success
enum<boolean>
Available options:
true
data
object