Skip to main content
GET
Get Narrative Record

Authorizations

Authorization
string
header
required

Team API key created in Team Settings. Use it with URLs for the same team.

Path Parameters

project
string<uuid>
required

Project UUID.

narrative
string<uuid>
required

The narrative UUID.

Query Parameters

brand
string<uuid>

Brand UUID of the project. Counts only that brand's mentions for first_seen_at and last_seen_at, as a report row with brand does. Without it every brand's mentions count.

Response

The narrative.

A narrative as a record, whatever the date range. Its numbers come from POST /api/v1/projects/{project}/reports/narratives.

uuid
string<uuid>
required
label
string
required
description
string | null
required

What answers say, or null when none is recorded.

sentiment
enum<string>
required

The narrative's own sentiment, as narrative_sentiment on report rows.

Available options:
positive,
neutral,
negative
theme_uuid
string<uuid> | null
required

The theme it belongs to, or null when it has none.

theme_label
string | null
required
first_seen_at
string<date-time> | null
required

When it was first said, across all time; null when never.

last_seen_at
string<date-time> | null
required

When it was last said, across all time; null when never.