---
title: "Summarize Events"
method: GET
path: "/api/v2/events/summary"
tags: ["Events"]
---

# Summarize Events

`GET /api/v2/events/summary`

Return dashboard-ready Event rollups by date, geography, category, or subcategory. Use group_by=subcategory under a parent category such as Battles to discover scoped sub-event buckets like Government regains territory, then reuse category+subcategory on /api/v2/events to fetch instances. Summaries use the same broad result coverage as Event lists and are designed for discovery before drilling into Events.

## Query parameters

- `group_by` 'date' | 'country' | 'region' | 'continent' | 'category' | 'subcategory'
- `date_start` string, date
- `date_end` string, date
- `country` string
- `region` 'Africa' | 'Asia' | 'Middle East' | 'Northern Africa' | 'Western Africa' | 'Eastern Africa' | 'Middle Africa' | 'Southern Africa' | 'Europe' | 'Eastern Europe' | 'South Asia' | 'Southeast Asia' | 'East Asia' | 'Central Asia' | 'North America' | 'Central America' | 'Caribbean' | 'South America' | 'Oceania'
- `continent` 'Africa' | 'Asia' | 'Europe' | 'North America' | 'South America' | 'Oceania'
- `admin1` string
- `bbox` string
- `event_family` 'conflict' | 'cameoplus'
- `category` string
- `subcategory` string
- `domain` 'POLITICAL' | 'ECONOMIC' | 'CORPORATE' | 'TECHNOLOGY' | 'INFRASTRUCTURE' | 'HEALTH' | 'DEMOGRAPHIC' | 'INFORMATION' | 'ENVIRONMENT' | 'CRIME'
- `has_fatalities` boolean
- `civilian_targeting` boolean
- `significance_min` number
- `significance_max` number
- `confidence_min` number
- `confidence_max` number
- `goldstein_scale_min` number
- `goldstein_scale_max` number
- `goldstein_severity_min` number
- `goldstein_severity_max` number
- `magnitude_min` number
- `magnitude_max` number
- `systemic_importance_min` number
- `systemic_importance_max` number
- `propagation_potential_min` number
- `propagation_potential_max` number
- `market_sensitivity_min` number
- `market_sensitivity_max` number
- `languages` string
- `limit` integer

## Response `200`

Event summary buckets

- object
  - `success` true
  - `data` EventSummaryBucket[]
    - `key` string, nullable
    - `group_by` string
    - `event_count` integer
    - `conflict_event_count` integer
    - `cameoplus_event_count` integer
    - `fatality_event_count` integer
    - `fatalities` integer
    - `fatality_event_rate` number
    - `country_count` integer
    - `region_count` integer
    - `article_count` integer
    - `avg_article_count` number
    - `max_article_count` integer
    - `avg_significance` number
    - `max_significance` number
    - `min_significance` number
    - `avg_goldstein_scale` number, nullable
    - `metrics` object — Nested aggregate statistics for significance and its generated input metrics.
    - `metric_stats` object — Alias of metrics for clients that prefer an explicit statistical field name.
    - `min_article_count` integer
    - `min_goldstein_scale` number, nullable
    - `max_goldstein_scale` number, nullable
    - `avg_goldstein_severity` number, nullable
    - `min_goldstein_severity` number, nullable
    - `max_goldstein_severity` number, nullable
    - `avg_magnitude` number, nullable
    - `min_magnitude` number, nullable
    - `max_magnitude` number, nullable
    - `avg_systemic_importance` number, nullable
    - `min_systemic_importance` number, nullable
    - `max_systemic_importance` number, nullable
    - `avg_propagation_potential` number, nullable
    - `min_propagation_potential` number, nullable
    - `max_propagation_potential` number, nullable
    - `avg_market_sensitivity` number, nullable
    - `min_market_sensitivity` number, nullable
    - `max_market_sensitivity` number, nullable
    - `avg_confidence` number, nullable
    - `min_confidence` number, nullable
    - `max_confidence` number, nullable

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/revisions/01aaa6255180/schema)