Skip to main content

​
Get Started in Three Steps

​
Step 1: Create Your Account

1

Sign up

Visit gdeltcloud.com/auth/sign-up and create your account.
2

Verify your email

Confirm your email and open the dashboard.
3

Explore the app

Start with the dashboard, Events, Stories, and entity pages.

​
Step 2: Understand Common Questions

These questions map to the v2 product surface: 
Show protests in India by day over the past month.
For analysis workflows, anchor on GDELT Cloud structured Events and Stories, then use macro-finance, prediction-market, and web-research tools when they add context.

​
Step 3: Make Your First API Call

For programmatic access, generate an API key with API access. Event, Story, and Entity list calls default to the exact past 24 hours. Narrow with developer-facing filters such as category, subcategory, country, region, continent, date windows up to 30 days, sort, and pagination. For Conflict Events, use ACLED-style event types such as Battles, Protests, or Explosions/Remote violence as category, then use sub-event types such as Armed clash or Peaceful protest as subcategory. event_family is deprecated in favor of category. 
curl "https://gdeltcloud.com/api/v2/events?country=Lebanon&category=Explosions%2FRemote%20violence&subcategory=Air%2Fdrone%20strike&has_fatalities=true&date_start=2026-04-11&date_end=2026-04-17&sort=significance&limit=5" \
  -H "Authorization: Bearer gdelt_sk_your_api_key_here"

​
What Data Is Available?

GDELT Cloud provides generated products built from the upstream GDELT Project article stream:
  • Events: structured Conflict and CAMEO+ records.
  • Stories: generated clusters of related articles with top article evidence.
  • Entities: people and organizations linked to Stories and Events.
  • Summaries: dashboard-ready rollups by date, geography, category, and subcategory.
  • Geo discovery: country-scoped admin1 values for state/province drilldown.
Data currently starts from January 2025, updates hourly, and is expanding historically over time.

​
Next Steps

API v2

Recommended REST API for Events, Stories, Entities, summaries, and geo discovery.

MCP Server

Connect through Progressive Discovery.

API Keys

Generate and manage API keys.