TraceeDocs

Research

Search social networks

Live posts mentioning a query on X, Reddit, LinkedIn, TikTok, YouTube and Instagram.

POSThttps://traceeai.com/api/v1/research/social-search

CLI:tracee research social-search·MCP:researchaction social_search

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
  • querystringrequired

    Words or a phrase

    up to 200 characters

  • platformsstring[]

    X, reddit, linkedin, youtube, tiktok, instagram, facebook

    up to 9 items

    Available options:xredditlinkedintiktokyoutubeinstagramhackernewsfacebookmeta

  • networksstring[]

    Older name for platforms (social_search and trends)

    up to 7 items

    Available options:xredditlinkedintiktokyoutubeinstagramhackernewsfacebook

  • daysinteger

    Look-back window

    1–90

  • 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.