TraceeDocs

Ads

Campaign performance

Spend, clicks, CTR, CPC, platform-reported leads, CRM contacts and MQLs and cost per lead for every campaign, on any set of platforms, with totals per platform and an optional comparison with the previous period.

GEThttps://traceeai.com/api/v1/ads/campaigns

CLI:tracee ads campaigns·MCP:adsaction campaigns

Authorizations

  • Authorizationstringheaderrequired

    Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

  • Tracee-Workspacestring

    For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.

    uuid

Query parameters

Lists: comma-separated or repeated
  • platformsstring[]

    The platforms

    up to 6 items

    Available options:googlemetalinkedintiktokredditpinterest

  • daysinteger

    Window ending today; 30 by default

    1–731

  • fromstring

    Start date, YYYY-MM-DD (with to, instead of days)

    pattern ^\d{4}-\d{2}-\d{2}$

  • tostring

    End date, YYYY-MM-DD

    pattern ^\d{4}-\d{2}-\d{2}$

  • campaign_idsstring[]

    Only these. From GET /api/v1/ads/campaigns

    up to 100 itemseach uuid

  • querystring

    Part of the campaign's name

    up to 4,000 characters

  • statusstring

    The status

    Available options:ActivePaused

  • sortstring

    The sort

    Available options:spendcrm_contactscrm_mqlscost_per_mqlcost_per_contactclicks

  • compareboolean

    Add the previous period

  • include_idleboolean

    Also those with no spend or leads

  • limitinteger

    The limit

    1–200

Response

Errors
  • 200Done.

    The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.