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

# Top precomputed narratives for a window

`GET /narratives/trending`

## Request

- Base URL: `https://api.kinetk.ai/graph`
- URL: `https://api.kinetk.ai/graph/narratives/trending`
- Auth: API key in header `x-api-key`

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-10-09** (0.1) `c9c05c737ac8`: 1 info
  - endpoint added
- **2026-07-21** (0.1) `483f5b6f2255`: 1 breaking
  - api path removed without deprecation

[Operation 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/3167795a69e5?raw)