TikTok Shop category trends
category_trends[Shop Analytics] The top TikTok Shop categories by estimated revenue over the last 7 days of data: revenue, units, growth, revenue per shop, top-3 and top-10 shop share, split by video, LIVE and affiliate. method=tree lists category names and ids (pass them as category to product_top_selling or creator_top_selling); method=products gives a category's top product ids; method=market_size counts what Shop Analytics tracks in a market, not all of TikTok Shop. region picks the market (default US). Example: {"method":"tree","keyword":"skincare"}.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "category_trends"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day). | |
| level | No | method=list or tree: keep only categories of this level (1 = top level, 3 = most specific). | |
| limit | No | method=tree: max categories to return (default 50). | |
| start | No | Shop Analytics methods: custom range start, YYYY-MM-DD. | |
| detail | No | compact (default) returns the useful fields; full adds the full raw record (large). | compact |
| method | No | What to get. list [Shop Analytics]: categories with revenue, growth and concentration | products [Shop Analytics]: a category's top product ids (US market only) | search [Shop Analytics]: find category names and ids by keyword | tree: category names and ids to use as category | market_size [Shop Analytics]: how many products, shops, creators, videos, LIVEs and brands Shop Analytics tracks | list |
| region | No | Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions. | |
| window | No | Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range. | |
| keyword | No | method=search: category name to look up, e.g. 'serum'. method=tree: text to find in category names, e.g. 'skincare'. | |
| category | No | method=products: category name exactly as method=list returns it (cate_id), e.g. 'Beauty & Personal Care'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||