Overview
GDELT Cloud supports multiple authentication methods depending on your use case:| Method | Use Case | Where |
|---|---|---|
| Session Auth | Web dashboard, interactive use | Browser |
| API Keys | Programmatic access, automation | REST API, MCP Server |
Session Authentication
Session authentication is used when accessing GDELT Cloud through the web dashboard.How It Works
1
Login
Navigate to gdeltcloud.com/auth/sign-in and enter your credentials.
2
Session created
Upon successful login, a secure session cookie is created and stored in your browser.
3
Automatic authentication
All dashboard features and internal API calls are automatically authenticated using this session.
Sessions are powered by Supabase Auth and include automatic token refresh for seamless long-term use.
Session Security
- Sessions expire after 7 days of inactivity
- HTTPS-only cookies prevent interception
- CSRF protection on all state-changing operations
- Optional two-factor authentication (coming soon)

