AI Tracker

Tracked competitor comparison

Changed on

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

Request

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. Omit with endDate set for All Time (from the first answer, no previous-period comparison).

endDatestring

YYYY-MM-DD

daysinteger

Days back from today on the team's calendar, converted to startDate/endDate. Ignored when startDate or endDate is set. 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.

homeOverview'true' | 'false'

Home chart projection: top eight non-user brands by share of voice and mentions, plus your brand. Global totals remain unchanged.

searchstring

Case-insensitive text matched against the brand name and website. Applied before limit; total, rows and roster cover the matches. Stats and trend stay unfiltered.

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.

includeTrendstring

Include the daily visibility trend across competitors. Defaults to true.

trendBrandsstring

Brands to keep in the trend: a JSON array of names, or 'default' for your brand plus up to 9 tracked competitors. Your brand is always kept. Omit for every brand.

includeRowsstring

Include the competitor rows. Defaults to true; set false when only the trend or matrices are needed.

rowFields'full' | 'roster'

roster returns every brand's name, website, flags and segment tags in roster instead of full rows, ignoring limit. Defaults to full.

Response

Default Response

competitorsobject
rosterobject[]
totalnumber
truncatedboolean

Changes

    • info

      added the new optional query request parameter search

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • breaking

      for the query request parameter days, default value 30 was added

    • warning

      for the query request parameter days, the min was set to 1.00