Skip to main content
GET
Get AI-ad frequency timeseries

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.

advertiserKey
string

Restrict the trend to a single advertiser (the advertiserKey from /ads/advertisers).

Response

Per-advertiser ad-frequency series + window total.

series
object[]
required
totalAds
integer
required

Filtered-window total ad appearances across all advertisers (not just the charted top-N).

dateRange
object
required

The resolved lookback window for this response.