TraceeDocs

Research

What's trending

Trending X topics and TikTok hashtags by country (and TikTok industry).

POSThttps://traceeai.com/api/v1/research/trends

CLI:tracee research trends·MCP:researchaction trends

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[]

    X, tiktok

    up to 9 items

    Available options:xredditlinkedintiktokyoutubeinstagramhackernewsfacebookmeta

  • networksstring[]

    Older name for platforms (social_search and trends)

    up to 7 items

    Available options:xredditlinkedintiktokyoutubeinstagramhackernewsfacebook

  • countrystring

    Two-letter country code; US by default

    exactly 2 characters

  • industrystring

    Trends on TikTok: one industry board

    Available options:apparel_accessoriesbaby_kids_maternitybeauty_personal_careeducationfood_beveragegameshealthhome_improvementhousehold_productsnews_entertainment

  • daysinteger

    Look-back window

    1–90

  • limitinteger

    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.