SEsearchable
Ads

List AI-ad advertisers

Changed on

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.

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

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.

filter'all' | 'competitors'

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

limitinteger

Page size. Defaults and caps vary by endpoint (see each operation's description); big list endpoints (cited domains/URLs, prompts, opportunities) cap at 1000, issues at 5000. Values above an endpoint's cap are clamped server-side, never rejected.

offsetinteger

Row offset for pagination.

Response

Advertisers page + brand ad stats + totals.

advertisersobject[] required
brandobject nullable

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

totalsobject required

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

paginationobject required

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

Changes