SEsearchable
Ads

List AI-ad creatives

Changed on

Individual ad creatives (deduped sponsored ad variations) surfaced in AI answers — advertiser, headline, body, image, landing URL, how many scraped responses each appeared in, the prompts + AI models it ran on, and first/last seen. A capped top-N by appearance count (no offset paging). days defaults to 30, max 365.

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

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

Scope to one advertiser (the advertiserKey from /ads/advertisers).

promptIdstring

Scope creatives to one tracked prompt — its id, or the prompt's text.

searchstring

Substring search over advertiser name + creative title.

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.

Response

Ad creatives.

creativesobject[] required
paginationobject required

limit + returnedCount. A capped top-N by appearance count — no offset paging.

Changes