SEsearchable
Ads

Get AI-ad frequency timeseries

Changed on

Per-advertiser daily ad-frequency trend — one series per top advertiser (brand force-included), each with a { date, adCount } array, plus the filtered-window total ad appearances. days defaults to 30, max 365.

get/api/mcp/projects/{projectId}/ads/timeseries

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Query parameters

daysinteger

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

platformstring

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.

advertiserKeystring

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

Response

Per-advertiser ad-frequency series + window total.

seriesobject[] required
totalAdsinteger required

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

Changes