List AI-ad advertisers
Who is running sponsored ads in AI answers, ranked by scraped ad-appearance volume, plus the brand’s own ad share of voice + rank (or null when the brand isn’t advertising) and project-wide totals. Offset-paginated. adCount is ads we scraped in AI answers, not ad-platform impressions. days defaults to 30, max 365.
Authorizations
A Searchable API key, created under Settings → Workspace → Integrations. Send as Authorization: Bearer sea_xxxxx. Every key carries one or more scopes (read, write, admin) and may optionally be bound to a single project — see Getting started.
Path Parameters
The project id.
Query Parameters
Lookback window in days. Default and maximum vary by endpoint — see the operation description.
x >= 1Comma-separated AI platform filter (e.g. chatgpt,claude,gemini). Accepted values and whether the param is required vary by endpoint — see the operation description.
all (default) or competitors to restrict to tracked competitors only.
all, competitors Page size. Default and maximum vary by endpoint — see the operation description.
x >= 1Row offset for pagination.
x >= 0Response
Advertisers page + brand ad stats + totals.
Project-wide totals, independent of pagination: totalAds, advertiserCount, competitorAdvertiserCount.
Offset pagination: limit, offset, returnedCount, totalCount (= advertiserCount), hasMore, nextOffset.
The resolved lookback window for this response.
The brand's own ad stats (adCount, share, rank among advertisers, platforms, top creative), or null when the brand isn't advertising.