Use cases

Monitors and API workflows

Ask a standing question once, or build directly on the same Events, Stories, Entities, Situations, REST, and MCP surfaces.

Monitor workflows

The standing questions teams ask every day

Schedule hourly or daily checks, preview the matches, then receive only new coverage by email or signed webhook on eligible plans.

Three GDELT Cloud Monitor views: AI Builder, Preview, and saved-run evidence

Supply-chain disruption Monitor

Resolve supplier names to stable IDs, watch disruption coverage, and investigate material involvement after the trigger.

Build the workflow

Corporate security Monitors

Route local operations, global critical incidents, and maritime disruption as separate standing questions.

Build the workflow

Reputation and labor-dispute watch

Combine resolved company IDs with semantic Story and Event matching, then follow up with tone and Share of Voice.

Build the workflow

GCC geopolitical Monitor

Use a compatible country list and family-scoped conflict taxonomy for one MENA desk escalation path.

Build the workflow

Evidence rail31

Entity contextSuez

Signed webhook application

Verify, deduplicate, and consume the versioned Monitor webhook in a customer-facing application.

Build the workflow

API & application workflows

Build on the same data layer

Use REST and MCP for dashboards, agents, country-sector analysis, and other applications that need structured world-state context.

Country & Sector Monitoring

Monitor a country and issue domain with summaries, significant Events, linked Stories — and the operating energy infrastructure rollup.

Open live tutorial

gdelt_cloud_tool_list()

search_events(country="Lebanon")

search_stories(has_events=true)

Agent World-State API

Give agents structured, queryable context about events, actors, places, risks, and physical energy infrastructure exposure.

Build the agent workflow

Evidence rail31

Entity contextSuez

API for Risk Dashboards

Populate internal tools with Events, Stories, Entities, Situations, and Energy Data assets without building the pipeline.

Build the dashboard

Publisher monitor

homepage_story → structured_event

Early Signals

Public daily watchlist showing how top publishers' homepage stories already appear as structured Events in the API — useful as a real-world reference of what the data can do.

Browse Early Signals