latestOpenAPI 3.0.02026-08-215090368.2 KB

c8f1f876a92c

AI Tracker

Tracked competitor comparison

Per-competitor AI-visibility rollup: visibility, mentions, citations, share of voice, sentiment and change vs the previous window, ordered by share of voice. Defaults to the top 25 brands without their daily history - raise limit or set includeHistory=true only if you need more, both grow the payload fast. matrices=true adds the per-AI-model breakdown. For every brand seen in answers rather than the tracked set, use ai_visibility_brands.

get/v3/ai-tracker/visibility/competitors

Query parameters

teamIdstring
platformstring

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

competitorstring

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

countrystring

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

startDatestring

YYYY-MM-DD

endDatestring

YYYY-MM-DD

daysinteger

Window length in days, ending today. Defaults to 30.

promptBrandstring

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

trackingstring

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

intentstring

Comma-separated prompt intents, or empty for all.

includePreviousstring

Include previous-period comparison values alongside each data point (roughly doubles the time-series payload). Defaults to false.

limitstring

Max competitor rows, or 'all'. Defaults to 25. Also bounds the trend series and the matrix; the response reports total and truncated.

includeHistorystring

Include each row's daily visibility sparkline (~85% of a row). Defaults to false.

matricesstring

Include the per-competitor x per-AI-model matrix. Defaults to false.