Skip to main content
GET
Get one AI Visibility daily rollup

Authorizations

Authorization
string
header
required

An agent key (rpk_...) created in Settings → API & MCP, sent as Authorization: Bearer rpk_.... Bearer only: a cookie session can never drive this API. An OAuth 2.1 access token obtained from the same host works identically and lands on the same ceiling.

Headers

X-Workspace-Id
string

Which workspace to read. Omit it and you get the account’s home workspace, which on an agency account is often not where the live businesses are. A workspace this credential cannot read is refused with 403 rather than quietly answered from the default.

Path Parameters

id
string
required

The AI Visibility daily rollup id.

Response

The AI Visibility daily rollup.

id
string

Unique id.

tracker_id
string
date
string
provider
string

Which backend produced the runs behind this rollup.

total_runs
integer
brand_mentions
integer
visibility_score
number

Percent (0-100) of the day's runs in which the brand was mentioned.

share_of_voice
object

Map of { brand_name: pct, <competitor_name>: pct } — mention frequency split, summing to ~100.

avg_position
number
sentiment_counts
object

{ positive, neutral, negative, mixed } counts over the day's runs where the brand was mentioned.

avg_sentiment_score
number
total_citations
integer
brand_citations
integer
by_engine
object

Per-engine breakdown, e.g. { chatgpt: { runs, brand_mentions, visibility_score }, gemini: {...} }.