---
title: "Summarize Stories"
method: GET
path: "/api/v2/stories/summary"
tags: ["Stories"]
---

# Summarize Stories

`GET /api/v2/stories/summary`

Return dashboard-ready Story rollups by date, geography, category, or subcategory. Summaries use broad result coverage and linked-Event aggregation. Use category/subcategory to filter by linked Event taxonomy. For group_by=category or group_by=subcategory, buckets are linked-Event taxonomy buckets, so narrative-only Stories are not counted in those taxonomy buckets.

## 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
- `category` string
- `story_category` 'conflict_security' | 'cameoplus_political' | 'cameoplus_crime' | 'cameoplus_economic' | 'cameoplus_corporate' | 'cameoplus_technology' | 'cameoplus_infrastructure' | 'cameoplus_environment' | 'cameoplus_health' | 'cameoplus_demographic' | 'cameoplus_information'
- `event_category` string
- `subcategory` string
- `domain` 'POLITICAL' | 'ECONOMIC' | 'CORPORATE' | 'TECHNOLOGY' | 'INFRASTRUCTURE' | 'HEALTH' | 'DEMOGRAPHIC' | 'INFORMATION' | 'ENVIRONMENT' | 'CRIME'
- `has_events` boolean
- `has_fatalities` boolean
- `civilian_targeting` boolean
- `article_count_min` integer
- `article_count_max` integer
- `languages` string
- `limit` integer

## Response `200`

Story summary buckets

- object
  - `success` true
  - `data` StorySummaryBucket[]
    - `key` string, nullable
    - `group_by` string
    - `story_count` integer
    - `article_count` integer
    - `avg_article_count` number
    - `max_article_count` integer
    - `stories_with_events` integer
    - `linked_event_count` integer — Total Story-to-Event links in this Story bucket, not a distinct Event total.
    - `avg_linked_event_count` number
    - `max_linked_event_count` integer
    - `stories_with_fatalities` integer
    - `fatalities` integer
    - `fatality_story_rate` number
    - `avg_significance` number
    - `max_significance` number
    - `min_significance` number
    - `metrics` object — Nested aggregate statistics for Story significance inputs and linked Event metrics.
    - `metric_stats` object — Alias of metrics for clients that prefer an explicit statistical field name.
    - `min_article_count` integer
    - `story_only_count` integer — Stories in the bucket with no linked structured Events.
    - `min_linked_event_count` integer
    - `avg_linked_event_significance` number, nullable
    - `min_linked_event_significance` number, nullable
    - `max_linked_event_significance` number, nullable
    - `avg_linked_event_goldstein_scale` number, nullable
    - `min_linked_event_goldstein_scale` number, nullable
    - `max_linked_event_goldstein_scale` number, nullable
    - `avg_linked_event_goldstein_severity` number, nullable
    - `min_linked_event_goldstein_severity` number, nullable
    - `max_linked_event_goldstein_severity` number, nullable
    - `avg_linked_event_magnitude` number, nullable
    - `min_linked_event_magnitude` number, nullable
    - `max_linked_event_magnitude` number, nullable
    - `avg_linked_event_systemic_importance` number, nullable
    - `min_linked_event_systemic_importance` number, nullable
    - `max_linked_event_systemic_importance` number, nullable
    - `avg_linked_event_propagation_potential` number, nullable
    - `min_linked_event_propagation_potential` number, nullable
    - `max_linked_event_propagation_potential` number, nullable
    - `avg_linked_event_market_sensitivity` number, nullable
    - `min_linked_event_market_sensitivity` number, nullable
    - `max_linked_event_market_sensitivity` number, nullable
    - `avg_linked_event_confidence` number, nullable
    - `min_linked_event_confidence` number, nullable
    - `max_linked_event_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/versions/01aaa6255180/schema)