Skip to main content
GET
List AI-ad advertisers

Authorizations

Authorization
string
header
required

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

projectId
string<uuid>
required

The project id.

Query Parameters

days
integer

Lookback window in days. Default and maximum vary by endpoint — see the operation description.

Required range: x >= 1
platform
string

Comma-separated AI platform filter (e.g. chatgpt,claude,gemini). Accepted values and whether the param is required vary by endpoint — see the operation description.

filter
enum<string>

all (default) or competitors to restrict to tracked competitors only.

Available options:
all,
competitors
limit
integer

Page size. Default and maximum vary by endpoint — see the operation description.

Required range: x >= 1
offset
integer
default:0

Row offset for pagination.

Required range: x >= 0

Response

Advertisers page + brand ad stats + totals.

advertisers
object[]
required
totals
object
required

Project-wide totals, independent of pagination: totalAds, advertiserCount, competitorAdvertiserCount.

pagination
object
required

Offset pagination: limit, offset, returnedCount, totalCount (= advertiserCount), hasMore, nextOffset.

dateRange
object
required

The resolved lookback window for this response.

brand
object | null

The brand's own ad stats (adCount, share, rank among advertisers, platforms, top creative), or null when the brand isn't advertising.