---
title: "Top precomputed narratives for a window"
method: GET
path: "/narratives/trending"
---

# Top precomputed narratives for a window

`GET /narratives/trending`

Reads precomputed narrative clusters for a bounded window. For live retrieval, submit `POST /intelligence/jobs` with `kind: insights`.

## Query parameters

- `limit` string
- `window` '30d' | '7d'

## Response `200`

Successful response

- ITrendingResponse
  - `narratives` INarrativeSummary[], required
    - `acceleration` number, nullable
    - `computed_at` string, required
    - `content_count` number, required
    - `creator_count` number, required
    - `diffusion` number, nullable
    - `emerging_score` number, required
    - `id` string, required
    - `label` string, required
    - `lifecycle` string, nullable
    - `momentum_score` number, required
    - `narrative_key` string, nullable
    - `overlap_count` number
    - `platform_count` number, required
    - `representative_content_uuid` string, nullable
    - `score_breakdown` INarrativeScoreBreakdown, required
      - `clustering_method` string
      - `content_count` number, required
      - `creator_count` number, required
      - `pair_count` number
      - `platform_count` number, required
      - `seed_tag` string
      - `total_engagement` number, required
    - `sentiment_breakdown` INarrativeSentimentBreakdown
      - `coverage` number
      - `dominant_tone` string, nullable
      - `stance` object, nullable
        - `critical` number, required
        - `mixed` number, required
        - `neutral` number, required
        - `supportive` number, required
      - `stance_coverage` number
    - `sentiment_label` string, nullable
    - `sentiment_score` number, nullable
    - `summary` string, required
    - `text_rank` number
    - `top_tags` string[], required
    - `total_engagement` string, required
    - `trajectory_confidence` string, nullable
    - `velocity` number, nullable
    - `window_end` string, required
    - `window_key` '30d' | '7d', required
    - `window_start` string, required
  - `window` '30d' | '7d', required

## Other responses

- `default` — Error response

## Changes

- **2026-06-25** `2077d5ecc87d` — 1 info
  - endpoint added
- **2026-06-10** `eaecae836740` — 1 breaking
  - api path removed without deprecation
- **2026-06-10** `f85c9ce4ec2e` — 11 breaking, 13 info
  - for the `query` request parameter `limit`, default value `12` was removed
  - for the `query` request parameter `window`, default value `7d` was removed
  - removed the enum value `24h` from the `query` request parameter `window`
  - the `narratives/items/computed_at` response's property format changed from `date-time` to no format for status `200`
  - …20 more

[Change history](https://skmtc.dev/kinetk/apis/kinetk-graph-service-api/changes/narratives/trending/get.md)

---

[API](https://skmtc.dev/kinetk/apis/kinetk-graph-service-api.md) · [All operations](https://skmtc.dev/kinetk/apis/kinetk-graph-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kinetk/apis/kinetk-graph-service-api/revisions/2077d5ecc87d?raw)