curl "https://gdeltcloud.com/api/v2/stories/story_123" \
  -H "Authorization: Bearer $GDELT_CLOUD_API_KEY"

import requests

url = "https://gdeltcloud.com/api/v2/stories/{story_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gdeltcloud.com/api/v2/stories/{story_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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
      }
    ]
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}