SNsnowseo
AI Tracker

Paged provider and position matrix for competitors

Changed on
get/v3/ai-tracker/visibility/competitor-matrix

Request

  • Base URL
    https://api.snowseo.com
  • URL
    https://api.snowseo.com/v3/ai-tracker/visibility/competitor-matrix
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

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.

pageinteger

1-based page. Default 1.

pageSizestring

Rows per page (max 1000), or 'all'. Every response reports total and totalPages.

view'provider' | 'position'
sortBystring
sortDir'asc' | 'desc'
pinnedFirst'true' | 'false'
filterTab'brands' | 'segments'
includeBrandsstring

JSON array of brand names to keep.

excludeBrandsstring

JSON array of brand names to drop.

statusesstring

JSON array of segment tags, with filterTab=segments.

Response

Default Response

Changes