curl "https://gdeltcloud.com/api/v2/events/conflict_13e29fd7" \
-H "Authorization: Bearer $GDELT_CLOUD_API_KEY"{
"success": true,
"data": {
"id": "conflict_13e29fd7",
"url": "https://gdeltcloud.com/story/example-story",
"primary_story_url": "https://gdeltcloud.com/story/example-story",
"family": "conflict",
"title": "Attack in Delft",
"summary": "A conflict Event coded from linked source articles.",
"event_date": "2026-04-15",
"category": "Violence against civilians",
"subcategory": "Attack",
"domain": "CONFLICT",
"event_code": "conflict_13e29fd7",
"geo": {
"country": "South Africa",
"region": "Southern Africa",
"continent": "Africa",
"admin1": "Western Cape",
"location": "Delft",
"latitude": -33.955,
"longitude": 18.634
},
"actors": [
{
"name": "Unknown armed actor",
"country": null,
"role": "actor1"
}
],
"metrics": {
"significance": 0.3585,
"goldstein_scale": -7,
"magnitude": null,
"systemic_importance": null,
"propagation_potential": null,
"market_sensitivity": null,
"confidence": 0.82,
"article_count": 1
},
"has_fatalities": true,
"fatalities": 4,
"story_refs": [
{
"id": "story_123",
"url": "https://gdeltcloud.com/story/example-story",
"title": "Delft mass shooting coverage",
"story_date": "2026-04-15",
"article_count": 1
}
],
"entity_refs": [],
"top_articles": [
{
"url": "https://www.example.com/delft-mass-shooting",
"title": "Delft mass shooting: child among 4 killed",
"domain": "example.com",
"rank": 1
}
]
}
}Fetch one known structured Event by ID.
curl "https://gdeltcloud.com/api/v2/events/conflict_13e29fd7" \
-H "Authorization: Bearer $GDELT_CLOUD_API_KEY"{
"success": true,
"data": {
"id": "conflict_13e29fd7",
"url": "https://gdeltcloud.com/story/example-story",
"primary_story_url": "https://gdeltcloud.com/story/example-story",
"family": "conflict",
"title": "Attack in Delft",
"summary": "A conflict Event coded from linked source articles.",
"event_date": "2026-04-15",
"category": "Violence against civilians",
"subcategory": "Attack",
"domain": "CONFLICT",
"event_code": "conflict_13e29fd7",
"geo": {
"country": "South Africa",
"region": "Southern Africa",
"continent": "Africa",
"admin1": "Western Cape",
"location": "Delft",
"latitude": -33.955,
"longitude": 18.634
},
"actors": [
{
"name": "Unknown armed actor",
"country": null,
"role": "actor1"
}
],
"metrics": {
"significance": 0.3585,
"goldstein_scale": -7,
"magnitude": null,
"systemic_importance": null,
"propagation_potential": null,
"market_sensitivity": null,
"confidence": 0.82,
"article_count": 1
},
"has_fatalities": true,
"fatalities": 4,
"story_refs": [
{
"id": "story_123",
"url": "https://gdeltcloud.com/story/example-story",
"title": "Delft mass shooting coverage",
"story_date": "2026-04-15",
"article_count": 1
}
],
"entity_refs": [],
"top_articles": [
{
"url": "https://www.example.com/delft-mass-shooting",
"title": "Delft mass shooting: child among 4 killed",
"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.
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Event ID returned by Search Events, for example conflict_... or cameoplus_....