Documentation IndexFetch the complete documentation index at: /llms.txtUse this file to discover all available pages before exploring further.
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
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 } ] } }
Fetch one known Story by ID with linked Events, linked Entities, metrics, public URL, normalized geo, and top 3 inline articles.
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Authorization: Bearer gdelt_sk_...
Story ID returned by Search Stories or linked from an Event.
Story detail
true
Show child attributes