Skip to main content
GET
List AI Visibility prompts

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 prompts.

id
string

Unique id.

tracker_id
string
location_id
string

Denormalized from the tracker for fast per-business usage counting.

text
string
tag
string

Optional single tag (persona / funnel stage). Multi-tag segmentation is deferred to v2.

variations
string[]

LLM-generated alternative phrasings of text (same intent, different wording — peec.ai style). Each run cycle asks the original plus every variation, so the visibility score samples how customers actually ask instead of one lucky wording. Generated once by runVisibilityTracker on the first run after the prompt is created; empty/absent = track the original only.

variations_generated_at
string
is_active
boolean