One TikTok Shop product
productEverything about one TikTok Shop product (id = product id or a Shop product link). Live from TikTok: page (price, SKUs and stock, rating, shop, and sold = TikTok's displayed lifetime units), reviews, related products, page videos. [Shop Analytics, any market via region]: sales, trend (daily), creators, video_sales, skus, analysis (highlights and attributes), conversion (creators promoting it and the share who sold), review_insights (complaints, praise, use cases; by_sku splits by variant). Examples: {"id":"1732052189676081387","method":"trend","window":"90d"}, {"ids":["1729...","1731..."],"method":"sales","region":"DE"}.
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": "product"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Product id (products[].id) or a TikTok Shop product link. | |
| end | No | Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day). | |
| ids | No | method=sales only: up to 20 product ids in one call. | |
| page | No | method=reviews: jump to this page (1-100). | |
| sort | No | method=reviews: recommended (default) or newest. | |
| limit | No | Results per page. reviews max 5, related max 30, videos max 20; Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes. | |
| stars | No | method=reviews: star filter when filter=all. | |
| start | No | Shop Analytics methods: custom range start, YYYY-MM-DD. | |
| by_sku | No | method=review_insights: split insights by SKU. | |
| cursor | No | Paging: pass the next value from the previous response unchanged. Omit on the first page. | |
| detail | No | compact (default) returns the useful fields; full adds the full raw record (large). | compact |
| filter | No | method=reviews: all (default), with_media or verified. | |
| method | No | What to get. page: live price, SKUs and stock, sold, rating, shop | reviews: public reviews | related: products TikTok shows as related | videos: the videos on the product page (first page only) | sales [Shop Analytics, 2 credits]: revenue, units, video/LIVE/showcase split, creator count, conversion (ids: up to 20 products) | trend [Shop Analytics, 2 credits]: daily revenue and units (up to ~13 months) | creators [Shop Analytics, 2 credits]: creators selling it, ranked, with revenue | video_sales [Shop Analytics, 2 credits]: videos selling it, with revenue | skus [Shop Analytics, 2 credits]: sales by variant (SKU) | analysis [Shop Analytics, 2 credits]: selling-point highlights and attributes Shop Analytics extracts for the product | conversion [Shop Analytics, 2 credits]: how many creators promote it and what share of them made sales | review_insights [Shop Analytics, 2 credits]: AI summary of reviews: pain points, praise, use cases (by_sku splits by variant) | page |
| 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||