One TikTok Shop seller
shopEverything about one TikTok Shop seller (id = sellerId, found on any of its products, or with shop_top_selling keyword=). Live: store (what shoppers see: rating, followers, catalogue). [Shop Analytics, any market via region]: sales (revenue, units, affiliate vs own vs mall), trend (daily), products, new_products, strategy (pricing, top affiliates unnamed), creators, videos, new_affiliates and affiliate_videos (daily counts with summary). Example: {"id":"7495514739648989419","method":"new_affiliates","window":"30d"}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "shop"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Seller id (sellerId on products and stores). | |
| end | No | Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day). | |
| slug | No | method=store: store slug if known; looked up when omitted. | |
| limit | No | Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes. | |
| start | No | Shop Analytics methods: custom range start, YYYY-MM-DD. | |
| 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 |
| method | No | What to get. store: live storefront: rating, sold, followers, products | sales [Shop Analytics]: revenue and units, split by own accounts, affiliates and mall | trend [Shop Analytics]: daily revenue and units (up to ~13 months) | products [Shop Analytics]: its products ranked by revenue | new_products [Shop Analytics]: products it launched in the window | strategy [Shop Analytics]: price bands and sales-channel mix: top affiliates (individuals unnamed) and the shop's own accounts | creators [Shop Analytics]: affiliate creators selling for it, with revenue | videos [Shop Analytics]: videos selling its products, with revenue | new_affiliates [Shop Analytics]: daily count of new affiliates who started promoting the shop, with a summary | affiliate_videos [Shop Analytics]: daily count of new videos affiliates posted for the shop, with a summary | store |
| 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 | |||