Skip to main content
GET
Get sentiment history

Authorizations

Authorization
string
header
required

A Searchable API key, created under Settings → Workspace → Integrations. Send as Authorization: Bearer sea_xxxxx. Every key carries one or more scopes (read, write, admin) and may optionally be bound to a single project — see Getting started.

Path Parameters

projectId
string<uuid>
required

The project id.

Query Parameters

days
integer

Lookback window in days. Default and maximum vary by endpoint — see the operation description.

Required range: x >= 1
platform
string

Comma-separated AI platform filter (e.g. chatgpt,claude,gemini). Accepted values and whether the param is required vary by endpoint — see the operation description.

topicId
string<uuid>

Restrict to a single topic id.

unbranded
enum<string>

Pass true to restrict every metric to non-branded prompts only.

Available options:
true
branded
enum<string>

Pass true to restrict every metric to branded prompts only.

Available options:
true
country
string

Comma-separated ISO 3166-1 country codes (e.g. US,GB) or country names.

locationId
string

Comma-separated tracked-location ids.

Response

Sentiment history.

project
object
required
summary
object
required
dataPoints
object[]
required
dateRange
object
required

The resolved lookback window for this response.