Skip to main content
GET
/
api
/
v1
/
cameoplus-events
/
summary
CAMEO+ Events Aggregate Summary
curl --request GET \
  --url http://localhost:3000/api/api/v1/cameoplus-events/summary
{
  "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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt

Use this file to discover all available pages before exploring further.

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. country: one bucket per country. region: one bucket per region. continent: one bucket per continent. event_code: one bucket per specific event code. category: alias for domain.

Available options:
date,
country,
region,
continent,
domain,
event_code,
category
​
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. Filters directly on the region column. Only one region may be specified per request.

Available options:
Middle East,
Northern Africa,
Western Africa,
Eastern Africa,
Middle Africa,
Southern Africa,
Europe,
South Asia,
Southeast Asia,
East Asia,
Central Asia,
North America,
Central America,
Caribbean,
South America,
Oceania
​
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
​
continent
enum<string>

Optional continent filter for geo rollups.

Available options:
Africa,
Asia,
Europe,
North America,
South America,
Oceania
​
geo_basis
enum<string>
default:location

How geographic buckets should be attributed: event location, actor geography, or both side by side.

Available options:
location,
actor,
combined
​
include_breakdowns
string

Optional comma-separated list of extra grouped sections to return in breakdowns.

Example:

"country,continent"

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