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.

​
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. 
# Conflict and disruption baseline
GET /api/v2/events?event_family=conflict&country=Lebanon&has_fatalities=true&sort=significance&date_start=2026-04-11&date_end=2026-04-17

# Economic and policy Events
GET /api/v2/events?event_family=cameoplus&domain=ECONOMIC&search=sanctions%20banking%20trade%20waiver&sort=significance

# Story evidence
GET /api/v2/stories?search=sanctions%20shipping%20energy%20corridor&article_count_min=1&sort=significance

​
What To Look For

  • Conflict Events affecting corridors, ports, oil, gas, or logistics.
  • CAMEO+ ECONOMIC, POLITICAL, INFRASTRUCTURE, and CORPORATE Events.
  • High market_sensitivity, systemic_importance, and propagation_potential.
  • Story evidence for sanctions evasion, rerouting, insurance, finance, and commodity exposure.

​
Enrichment

Use macro-finance tools for FX, commodities, rates, and indices. Use prediction-market tools for policy, election, conflict, or macro probabilities. Use web research for sanctions notices, regulator releases, and specialist reporting.