Skip to main content

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.

​
Why Structured Events Matter

GDELT Cloud Events let analysts see concrete actions side by side: protests, attacks, sanctions, diplomatic moves, infrastructure disruptions, and policy changes. This makes it possible to trace trajectories before a major Story breaks and to detect patterns across regions that plain web search may miss.

​
Workflow

Event and Story list/summary endpoints default to confidence_profile=precise for analyst-ready results. Add confidence_profile=loose only when exhaustive/raw retrieval is required. 
# Establish the trajectory
GET /api/v2/events/summary?region=Middle%20East&event_family=conflict&group_by=date&date_start=2026-04-01&date_end=2026-04-17

# Drill into significant Events
GET /api/v2/events?region=Middle%20East&event_family=conflict&sort=significance&date_start=2026-04-11&date_end=2026-04-17

# Compare narrative layer
GET /api/v2/stories?region=Middle%20East&has_events=true&sort=significance&date_start=2026-04-11&date_end=2026-04-17

​
Analytical Moves

  • Trajectory tracing: What Events preceded the focal Story?
  • Pattern mosaic: Which distant Events form a signal when viewed together?
  • Restraint as signal: Is an actor choosing not to escalate during an opening?
  • Narrative-vs-structure: Are Stories overemphasizing one narrative while Events show a different operational picture?
  • Historical discipline: When a user asks about a past window, use only that window.

​
Enrichment

Use prediction-market tools for election, policy, conflict, or crisis probability context. Use macro-finance tools when sovereign risk, rates, FX, energy, or commodities matter. Use web research for official statements and source corroboration.