Skip to main content
GET
Tracked prompts with per-prompt visibility metrics
Your tracked prompts with per-prompt visibility, position, share of voice, sentiment, run status, and next scheduled run. Paginated via page / pageSize, with sort, dir, and search. Pass fields=minimal for just { id, prompt }. Unlike the other endpoints this defaults to your full history, not the last 30 days. Scope filters are described on AI Visibility.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string
platform
string

Comma-separated AI platform names, or 'All Platforms' for no filter.

competitor
string

Comma-separated competitor names, or 'All Competitors' for no filter. Keeps prompts where ANY listed competitor appears.

country
string

Comma-separated ISO2 country codes, or 'All Countries' for no filter.

startDate
string

YYYY-MM-DD. Omit with endDate set for All Time (from the first answer, no previous-period comparison).

endDate
string

YYYY-MM-DD

days
integer
default:3650

Days back from today on the team's calendar, converted to startDate/endDate. Ignored when startDate or endDate is set. Defaults to 3650.

Required range: x >= 1
promptBrand
string

'branded', 'unbranded', or 'all'.

tracking
string

'tracked', 'untracked', or empty for both.

intent
string

Comma-separated prompt intents, or empty for all.

fields
string

'full' (default) for metrics per prompt, or 'minimal' for {id, prompt} only. Minimal ignores all scope filters and pagination.

page
integer

1-based page. Default 1.

pageSize
string

Rows per page, or 'all'. Defaults to 25. The response reports totalRows and totalPages.

sort
string

prompt | mentions | visibility | position | sov | sentiment | updatedAt. Omit for the dashboard default (pinned, then processing, then most recently updated).

dir
string

asc | desc. Default desc.

pinnedFirst
string

Keep pinned, then processing, then tracked rows ahead of the sort (the management table's order). Defaults to false.

Case-insensitive substring match on prompt text.

Response

Default Response

meta
object
table
object
prompts
object[]