Skip to main content
GET
/
api
/
v2
/
events
/
{event_id}
cURL
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.

Authorizations

Authorization
string
header
required

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

Path Parameters

event_id
string
required

Event ID returned by Search Events, for example conflict_... or cameoplus_....

Response

Event detail

success
enum<boolean>
Available options:
true
data
object