---
title: "Get Story"
method: GET
path: "/api/v2/stories/{story_id}"
tags: ["Stories"]
---

# Get Story

`GET /api/v2/stories/{story_id}`

Fetch one known Story by ID with linked Events, linked Entities, metrics, public URL, normalized geo, and top 3 inline articles.

## Path parameters

- `story_id` string, required

## Response `200`

Story detail

- object
  - `success` true
  - `data` StoryCard
    - `id` string
    - `url` string, uri, nullable
    - `title` string, nullable
    - `image_url` string, uri, nullable — First available top-article sharing image promoted to the Story card.
    - `story_date` string, date
    - `category` string, nullable
    - `subcategory` string, nullable
    - `geo` Geo
      - `country` string, nullable
      - `region` string, nullable
      - `continent` string, nullable
      - `admin1` string, nullable
      - `location` string, nullable
      - `latitude` number, nullable
      - `longitude` number, nullable
    - `geo_context` GeoContext — Explains broad geography matches. geo is the event/story location; actor_origin_countries explains matches where the requested country, region, or continent came from actor origin instead.
      - `location_country` string, nullable
      - `actor_origin_countries` string[]
    - `metrics` object
      - `significance` number
      - `article_count` integer
      - `linked_event_count` integer
      - `max_linked_event_significance` number
      - `civilian_targeting_event_count` integer — Number of linked Events with ACLED civilian_targeting populated.
    - `has_events` boolean
    - `has_fatalities` boolean
    - `fatalities` integer
    - `linked_events` object[]
    - `entity_refs` EntityRef[]
      - `id` string
      - `name` string
      - `type` string, nullable
      - `wikipedia_url` string, uri, nullable
      - `image_url` string, uri, nullable — Best-effort Wikipedia thumbnail URL for UI rendering.
      - `avatar_url` string, uri, nullable — Best-effort compact avatar URL, usually the same as image_url.
    - `top_articles` Article[]
      - `id` string, nullable
      - `url` string, uri
      - `title` string, nullable
      - `domain` string, nullable
      - `domain_avatar_url` string, uri, nullable — Best-effort source-domain avatar/favicon URL for UI rendering.
      - `image_url` string, uri, nullable — Best-effort source article sharing image from the GDELT GKG layer.
      - `article_date` string, date, nullable
      - `rank` integer, nullable
      - `role` string, nullable
    - `has_civilian_targeting` boolean — True when linked Conflict Events include civilian targeting evidence.

## Other responses

- `404` — Resource not found

---

[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)