Skip to main content
GET
/
api
/
v1
/
cameoplus-events
/
summary
CAMEO+ Events Aggregate Summary
curl --request GET \
  --url https://gdeltcloud.com/api/v1/cameoplus-events/summary \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "group_by": "<string>",
  "totals": {
    "event_count": 123,
    "avg_magnitude": 123,
    "max_magnitude": 123,
    "avg_market_sensitivity": 123,
    "max_market_sensitivity": 123,
    "avg_systemic_importance": 123,
    "max_systemic_importance": 123,
    "avg_propagation_potential": 123,
    "avg_goldstein_scale": 123,
    "avg_confidence": 123,
    "countries_affected": 123,
    "domains_active": 123,
    "centroid_lat": 123,
    "centroid_lon": 123
  },
  "buckets": [
    {
      "date": "<string>",
      "country": "<string>",
      "domain": "<string>",
      "event_code": "<string>",
      "event_count": 123,
      "avg_magnitude": 123,
      "max_magnitude": 123,
      "avg_market_sensitivity": 123,
      "max_market_sensitivity": 123,
      "avg_systemic_importance": 123,
      "max_systemic_importance": 123,
      "avg_propagation_potential": 123,
      "avg_goldstein_scale": 123,
      "avg_confidence": 123,
      "countries_in_bucket": 123,
      "domains_in_bucket": 123,
      "centroid_lat": 123,
      "centroid_lon": 123
    }
  ],
  "filters": {},
  "metadata": {
    "bucket_count": 123,
    "execution_time_ms": 123
  }
}

Authorizations

​
Authorization
string
header
required

API key format: gdelt_sk_<64-hex-chars>. Generate in Dashboard → Settings → API Keys.

Query Parameters

​
group_by
enum<string>
default:domain

Dimension to group results by. domain (default): one bucket per CAMEO+ domain. date: one bucket per day (ascending). country: one bucket per country. event_code: one bucket per specific event code.

Available options:
date,
country,
domain,
event_code
​
days
integer
default:7

Lookback window in days from date. Default 7, max 90.

Required range: 1 <= x <= 90
​
date
string<date>

Anchor/end date (YYYY-MM-DD). Defaults to today UTC.

Example:

"2026-03-10"

​
domain
enum<string>

Filter to a specific CAMEO+ domain.

Available options:
POLITICAL,
ECONOMIC,
CORPORATE,
TECHNOLOGY,
INFRASTRUCTURE,
ENVIRONMENT,
HEALTH,
DEMOGRAPHIC,
INFORMATION
​
event_code
string

Filter by event code (exact) or domain prefix (e.g. 'EC02' for Monetary Policy only; 'EC' for all ECONOMIC codes). Most useful when combined with group_by=event_code to see a breakdown by code, or with domain filter to drill into a specific sub-type. All valid codes: EC01–EC07, CO01–CO08, TE01–TE06, IN01–IN06, EN01–EN05, HE01–HE05, DE01–DE05, IF01–IF04. POLITICAL uses standard CAMEO 2-digit codes (01–17).

Example:

"EC02"

​
country
string

Filter to a specific ISO-3 country code.

Example:

"USA"

​
region
enum<string>

Filter to a geographic region. Expands to the corresponding list of ISO-3 country codes. Only one region may be specified per request.

Available options:
Western Africa,
Middle East,
Eastern Africa,
Southern Asia,
East Asia,
Eastern Europe,
Latin America & Caribbean,
South-Eastern Asia,
Northern America,
Western Europe,
Central Asia,
Oceania,
Middle Africa,
Northern Africa,
Southern Africa,
Caribbean,
Central America
​
admin1
string

First-level administrative division (state, province, region) as stored in GDELT. Must be used with country. Use the full official name. Examples: 'California' (USA), 'Bavaria' (Germany), 'São Paulo' (Brazil), 'Guangdong' (China), 'Île-de-France' (France), 'New South Wales' (Australia), 'Uttar Pradesh' (India).

Example:

"California"

​
magnitude_min
number

Minimum magnitude score (0–10).

Required range: 0 <= x <= 10
​
magnitude_max
number

Maximum magnitude score (0–10).

Required range: 0 <= x <= 10
​
systemic_min
number

Minimum systemic_importance (0–1).

Required range: 0 <= x <= 1
​
market_min
number

Minimum market_sensitivity (0–1).

Required range: 0 <= x <= 1

Response

Success

​
success
boolean
​
group_by
string
​
totals
object

Aggregate across the entire filtered dataset.

​
buckets
object[]

One object per group_by value.

​
filters
object
​
metadata
object