TraceeDocs

Research

Competitors' ads

The ads a company or keyword runs in the Meta and LinkedIn ad libraries.

POSThttps://traceeai.com/api/v1/research/ads-library

CLI:tracee research ads-library·MCP:researchaction ads_library

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

Body

application/json
  • platformsstring[]

    Meta (facebook, instagram), linkedin. All the action covers by default

    up to 9 items

    Available options:xredditlinkedintiktokyoutubeinstagramhackernewsfacebookmeta

  • companystring

    The advertiser's name

    up to 200 characters

  • domainstring

    A company's website or domain, e.g. stripe.com

    up to 200 characters

  • keywordstring

    Search ads by keyword

    up to 200 characters

  • countrystring

    Two-letter country code; US by default

    exactly 2 characters

  • limitinteger

    The limit

    1–100

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.