Skip to main content
GET
List AI Visibility daily rollups

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.

Query Parameters

q
string

JSON filter object, for example {"needs_response":true}.

sort_by
string

Field to sort on.

limit
integer

Maximum rows to return.

skip
integer

Rows to skip, for paging.

Response

Matching AI Visibility daily rollups.

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: {...} }.