Skip to main content

​
Overview

API keys provide secure programmatic access to GDELT Cloud for automated scripts, applications, and integrations. Use API keys to query data, create alerts, and manage resources via the REST API.
API keys are only available on Pro and Enterprise plans.

​
Generating API Keys

1

Navigate to API Keys

From your dashboard, go to Settings → API Keys
2

Create new key

Click Create New Key and provide:
  • Name: Descriptive name (e.g., “Production Server”, “Dev Environment”)
  • Optional notes: Internal description for your reference
3

Copy your key

Important: Your API key will only be shown once. Copy it immediately and store it securely.
The key format is: gdelt_sk_<64_hexadecimal_characters>Example: gdelt_sk_a1b2c3d4e5f6... (64 hex characters total)
4

Store securely

Save your API key using:
  • Environment variables
  • Secret managers (AWS Secrets Manager, HashiCorp Vault)
  • Encrypted configuration files
Never commit API keys to version control or share them publicly.

​
Using API Keys

​
Authentication Header

Include your API key in the Authorization header using the Bearer scheme: 
Authorization: Bearer gdelt_sk_your_api_key_here

​
Code Examples

curl -X POST https://gdeltcloud.com/api/query/execute \
  -H "Authorization: Bearer gdelt_sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sql": "SELECT * FROM gdelt_events WHERE day >= '\''2025-01-01'\'' LIMIT 10"
  }'