Global Event
Monitoring

# pip install requests
import os
import requests

api_key = os.environ["GDELT_CLOUD_API_KEY"]
response = requests.get(
    "https://gdeltcloud.com"
    "/api/v2/events",
    params={
        "sort": "significance",
        "limit": "8",
        "search": "gas",
        "country": "USA,CAN,AUS,GUY",
        "category": "INFRASTRUCTURE",
        "date_end": "2026-09-15",
        "date_start": "2026-08-17",
        "search_mode": "lexical",
        "subcategory": "IN01",
        "observed_end": "2026-09-15T06:15:22.660Z",
        "country_match": "location",
        "include_images": "true",
        "observed_start": "2026-09-14T06:15:22.660Z",
        "include_entity_images": "false"
    },
    headers={
        "Authorization": "Bearer " + api_key,
        "Accept": "application/json",
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())