API keys

# Significant structured Events
curl "https://gdeltcloud.com/api/v2/events?country=Lebanon&category=Battles&subcategory=Armed%20clash&has_fatalities=true&limit=10" \
  -H "Authorization: Bearer gdelt_sk_your_api_key_here"

import requests, os

API_KEY = os.environ["GDELT_API_KEY"]
BASE = "https://gdeltcloud.com/api/v2"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Protests in India
resp = requests.get(f"{BASE}/events", headers=headers,
                    params={"country": "India", "category": "Protests", "subcategory": "Peaceful protest", "limit": 10})
data = resp.json()
print(f"{len(data['data'])} events")

# Entity profile
resp = requests.get(f"{BASE}/entities", headers=headers,
                    params={"search": "NATO", "limit": 5})
print(resp.json()["data"])

const API_KEY = process.env.GDELT_API_KEY;
const BASE = "https://gdeltcloud.com/api/v2";
const headers = { "Authorization": `Bearer ${API_KEY}` };

// Story search
const resp = await fetch(`${BASE}/stories?continent=Asia&search=data%20center%20projects&limit=10`,
  { headers });
const data = await resp.json();
console.log(`${data.data.length} stories`);