Skip to main content
GET
Reputation Overview

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.

Query Parameters

start_date
string<date>
required
end_date
string<date>
required

Must be on or after start_date.

tags
string[]

Tag UUID or name filters. Repeat as tags[]=<uuid-or-name>. Discover tags with GET /api/v1/projects/{project}/tags.

services
string[]

AI platform provider filters such as chatgpt or perplexity. Repeat as services[]=<provider>. Discover providers with GET /api/v1/platforms.

countries
string[]

Country code filters such as US or GB. Repeat as countries[]=<code>. Discover codes with GET /api/v1/countries.

topics
string[]

Topic UUID or name filters. Use no_topic for prompts without a topic. Repeat as topics[]=<uuid-or-name>. Discover topics with GET /api/v1/projects/{project}/topics.

prompt
string<uuid>

Prompt UUID filter.

brand
string<uuid>

Brand UUID to scope the reputation data to. Must belong to the project. Defaults to the project's primary brand; when the project has no primary brand an explicit brand is required. Discover brand UUIDs with GET /api/v1/projects/{project}/brands.

Response

Reputation overview KPIs.

Headline reputation KPIs for the window. previous_sentiment_score is null when the prior window had no data; narrative counts always carry a previous (zero when empty).

sentiment_score
integer
required

Net Sentiment Index across all narrative mentions in the window (0-100).

previous_sentiment_score
integer | null
required
active_narratives
integer
required

Number of narratives mentioned in the window.

previous_active_narratives
integer
required