SEsearchable
Ads

List ad-surfacing prompts

Changed on

Which tracked prompts surface the most sponsored ads — per-prompt ad-unit count, ad coverage percent (share of the prompt's responses that carried an ad), response count, and the AI engines that surfaced ads. Server-sorted. days defaults to 30, max 365.

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

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.

sortBy'promptText' | 'adUnits' | 'coveragePct' | 'engines' | 'totalResponses'

Sort column (default adUnits).

sortDir'asc' | 'desc'

Sort direction (default desc).

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-surfacing prompts.

promptsobject[] required
paginationobject required

limit + returnedCount.

Changes