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.
What is GDELT Cloud?
GDELT Cloud turns the upstream GDELT Project article stream into a real-time structured Events database, with clustered Stories, linked Entities, summaries, API, and MCP tools around it. The coded Events are the backbone: Conflict and CAMEO+ records with geography, actors, categories, metrics, and source evidence. Product data currently extends back to January 2025 and accumulates daily as new events are processed. Historical coverage is expanding over time. Data updates every hour, giving you near real-time access to what’s happening around the world.REST API
Programmatic access to v2 Events, Stories, Entities, summaries, and geo discovery. v1 remains available for existing integrations.
MCP Server
Connect MCP clients directly to GDELT Cloud Events, Stories, Entities, and enrichment tools.
API Keys
Generate API keys for programmatic access.
How the Data Works
The upstream GDELT Project monitors news sources worldwide. GDELT Cloud uses that article stream as input, then generates its own user-facing product data: structured Events, clustered Stories, linked Entities, summaries, metrics, and article evidence.Articles
Articles
The GDELT Project ingests news articles from global sources. GDELT Cloud uses that article stream as the raw signal behind our generated Stories, Events, and Entities.
Generated Events
Generated Events
GDELT Cloud generates structured Events from story clusters: Conflict Events and CAMEO+ Events. Events include normalized geography, actors, categories, metrics, and source Story links.
Stories
Stories
Related articles covering the same development are grouped into Stories. Story records include article evidence, linked Events, linked Entities, normalized geography, and generated significance metrics.
Entities
Entities
People and organizations mentioned in articles are linked across Stories and Events. Entity endpoints are first-class in v2 and are designed for actor-centered drilldown.
Conflict Events
Conflict Events
News clusters covering political violence, armed conflict, protests, riots, and strategic developments are coded into GDELT Cloud Conflict Events following ACLED-style methodology. We generate our own records from GDELT Project article-derived clusters; we do not redistribute ACLED data.
What You Can Do
Monitor Structured Events
Query generated Conflict and CAMEO+ Events by country, region, continent, category, metric, date window, or semantic search.
Trace Event Trajectories
Use Event summaries and Event cards to follow how protests, attacks, policy moves, infrastructure incidents, and market-relevant signals evolve.
Profile Entities
Look up people or organizations to see linked Stories and Events.
Track Conflict Events
Browse generated conflict and political violence Events with normalized geo, fatalities, Goldstein scale, and source Story links.
Verify With Stories
Inspect clustered Stories for article evidence, linked Events, linked Entities, and source URLs.
Get Started
Create an account
Sign up at gdeltcloud.com/auth/sign-up to get started with a free account.
Explore the product data
Review Events, Stories, Entities, and summaries to understand the generated product layer.
Use Cases
Conflict Monitoring
Track protests, military actions, and diplomatic events across any region.
Story And Entity Analysis
Analyze clustered narratives, source evidence, and entity mentions across global media sources.
Risk Assessment
Monitor geopolitical risks, social unrest, and emerging conflicts for business intelligence.
Academic Research
Access structured event data for social science, political science, and international relations research.
Quickstart Guide
Follow our quickstart guide to make your first query in under 5 minutes.
Source and Product Data: GDELT Project article data is the upstream public signal. The user-facing records in GDELT Cloud are generated GDELT Cloud Events, Stories, Entities, metrics, summaries, and linked article evidence.