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.

​
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 and Story list/summary calls default to confidence_profile=precise for clean, analyst-ready results. Add confidence_profile=loose only when you need exhaustive/raw retrieval. 
curl "https://gdeltcloud.com/api/v2/events?country=Lebanon&event_family=conflict&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.