TikTok Shop MCP tools: every input and sample output

TokConnect's TikTok Shop MCP server has 12 tools for sales data: seven that rank the market or list its markets, and five that read one product, shop, creator, video or LIVE. TokConnect is the TikTok research platform with an MCP server and API that gives ChatGPT, Claude, Cursor, n8n and your own code TikTok Shop sales, products, shops, creators, videos and LIVE data in 17 markets, and this page is its reference: every tool's inputs, its REST route, a real call and a prompt that makes your AI run it.

Share or embed this infographic

Free to use on your site, in a deck or a newsletter with a credit link to TokConnect. Copy the code below.

<a href="https://tokconnect.com/developers/tiktok-shop-mcp-tools/"><img src="https://tokconnect.com/graphics/tiktok-shop-mcp-tools/summary.svg" alt="TikTok Shop MCP tools reference: 12 tools, 50 REST routes, 1 credit a call, refunded when a call fails" width="1200" height="630" style="max-width:100%;height:auto"></a><br>Source: <a href="https://tokconnect.com/developers/tiktok-shop-mcp-tools/">TikTok Shop MCP tools reference: every tool, input and sample output</a> on TokConnect

Copy embed code

Which TokConnect tool answers which question?

Pick the ranking tool when you do not have an id yet, and the entity tool when you do. TokConnect's rankings hand you ids (a product id, a seller id, a creator id, a video id, a LIVE id), and the entity tools turn each id into sales, trends and the people behind them.

Share or embed this infographic

Free to use on your site, in a deck or a newsletter with a credit link to TokConnect. Copy the code below.

<a href="https://tokconnect.com/developers/tiktok-shop-mcp-tools/"><img src="https://tokconnect.com/graphics/tiktok-shop-mcp-tools/tool-map.svg" alt="Which tool answers which question: product_top_selling for what sells most, shop_top_selling for winning shops, creator_top_selling for top affiliates, video_top_selling, live_top_selling, category_trends, shop_regions, and the product, shop, creator_commerce, video and live tools for one item" width="1200" height="1010" style="max-width:100%;height:auto"></a><br>Source: <a href="https://tokconnect.com/developers/tiktok-shop-mcp-tools/">TikTok Shop MCP tools reference: every tool, input and sample output</a> on TokConnect

Copy embed code

Source: TokConnect tool list and REST route table, 29 October 2026. TokConnect's shop_browse tool adds 6 routes under /v1/storefront/ for the live TikTok Shop storefront, which makes the 56 TikTok Shop routes on the TikTok Shop data API page.

How do you call these tools?

You call a TokConnect tool in one of two ways, and both run the same code. Over MCP your AI picks the tool and the arguments from your prompt: connect https://mcp.tokconnect.com/mcp with the connect steps or the guides for ChatGPT, Claude, Cursor and Claude Code, and every plan includes it. Over REST you send a GET to https://api.tokconnect.com/v1 with an X-API-Key header on the Pro and Enterprise plans, and the arguments go in the query string.

curl "https://api.tokconnect.com/v1/markets" -H "X-API-Key: YOUR_TOKCONNECT_KEY"

Every success response from TokConnect's REST API wraps the tool's JSON in data, adds next_cursor when there is another page, and carries meta.credits_charged. The samples below show the tool's JSON, which is what you read from data.

Which inputs do all TokConnect Shop tools share?

Every TokConnect Shop Analytics tool takes these inputs, so each tool section below lists only what is specific to it. The market and window apply to the analytics methods; amounts come back in the market's currency.

Source: TokConnect tools/list input schemas, 29 October 2026. Open the schemas.

TokConnect's markets are US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR and MX (core), plus PL, IT, NL and IE (extended). Product, shop and creator ids belong to one market, so use them with the same region. TokConnect's data ends about 2 days before the day you ask.

product_top_selling: rank products by estimated sales

TokConnect ranks every TikTok Shop product that matches a keyword or category over your window, by revenue, units, price, growth or number of creators, with up to 100 rows a page and about 700 rows per keyword (max_rows scans up to 3,000 in the US). With neither a keyword nor a category it returns the top 10 products of the latest days of data.

TokConnect REST: GET /v1/products/top

Inputs

Prompt

Sample call. MCP arguments:

{"keyword":"cat litter box","region":"US","window":"30d","sort":"revenue","limit":10}

TokConnect's REST route for this call: GET /v1/products/top?keyword=cat%20litter%20box&region=US&window=30d&sort=revenue&limit=10. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "keyword": "cat litter box",
  "totalMatched": 258,
  "dataEnd": "2026-10-26",
  "window": {
    "days": 30,
    "end": "2026-10-26",
    "start": "2026-09-27"
  },
  "sortedBy": "revenue",
  "items": [
    {
      "id": "1732277424593932739",
      "product_title": "PetPivot AutoScooper 12 Lite Open-Top Automatic Self-Cleaning Cat Litter Box, Easy-Entry Front Step, Triple Safety Protection, No App Required,SohoChic",
      "revenue": "$655.71k",
      "sale": 5083,
      "unit_price": "$129.00",
      "commission_rate": "8%",
      "creator_num": 605,
      "creator_conversion_ratio": 0.2413223140495868,
      "video_revenue": "$527.61k",
      "live_revenue": "$127.84k",
      "showcase_revenue": "$258.00",
      "revenue_grouping_rate": "-14.2%",
      "launch_date": "2026-03-02"
    }
  ],
  "next": "eyJwYWdlIjoyLCJzaXplIjoxMH0"
}

shop_top_selling: rank shops and brands

TokConnect ranks TikTok Shop sellers by estimated revenue, units or growth, with the split between their own accounts, affiliates and the mall. keyword matches a shop or brand name, not a product type. type=brands lists the top 10 brands, and without a keyword you get the top 10 shops of the latest days.

TokConnect REST: GET /v1/shops/top

Inputs

Prompt

Sample call. MCP arguments:

{"keyword":"petpivot","region":"US","window":"30d","limit":3}

TokConnect's REST route for this call: GET /v1/shops/top?keyword=petpivot&region=US&window=30d&limit=3. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "keyword": "petpivot",
  "totalMatched": 4,
  "dataEnd": "2026-10-26",
  "window": {
    "days": 30,
    "end": "2026-10-26",
    "start": "2026-09-27"
  },
  "sortedBy": "revenue",
  "items": [
    {
      "id": "7495791587377711555",
      "name": "PetPivot",
      "region": "US",
      "seller_type": "BRAND",
      "revenue": "$1.60m",
      "sale": 17032,
      "unit_price": "$94.17",
      "revenue_grouping_rate": "23.1%",
      "affiliate_revenue": "$1.36m",
      "self_promotion_revenue": "$236.60k",
      "shopping_mall_revenue": "$5.36k",
      "video_revenue": "$1.10m",
      "live_revenue": "$483.45k",
      "showcase_revenue": "$18.23k"
    }
  ]
}

creator_top_selling: rank affiliates and creators

TokConnect ranks the creators who drove TikTok Shop sales over a window, with followers, engagement, views and trend, and filters for followers, engagement, average views, price, gender, language, contact channel, MCN signing and audience age. keyword matches creator names and bios, not the products they sell; use category for the creators of a product type.

TokConnect REST: GET /v1/affiliates/top

Inputs

Prompt

Sample call. MCP arguments:

{"category":["Pet Supplies"],"followers":"10000-100000","window":"30d","sort":"revenue","limit":5,"region":"US"}

TokConnect's REST route for this call: GET /v1/affiliates/top?category=Pet%20Supplies&followers=10000-100000&window=30d&sort=revenue&limit=5&region=US. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "category": [
    {
      "id": "602118",
      "name": "Pet Supplies"
    }
  ],
  "filters": [
    "followers=10000-100000"
  ],
  "dataEnd": "2026-10-26",
  "window": {
    "days": 30,
    "end": "2026-10-26",
    "start": "2026-09-27"
  },
  "sortedBy": "revenue",
  "items": [
    {
      "handle": "masked",
      "creatorDebut": "2024-05-20",
      "followers": "28.6k",
      "new_followers": "1.3k",
      "revenue": "$153.86k",
      "sale": "1.21k",
      "unit_price": "$127.27",
      "views": "16.11m",
      "video_engagement_rate": "2.4%",
      "revenue_grouping_rate": -0.5070781948905039
    }
  ]
}

video_top_selling: the top shoppable videos

TokConnect lists the top 10 shoppable videos by estimated revenue, with units, views, GPM, ad cost, CPA, ROAS, ad revenue share and whether the video is AI-generated. The data source applies no filters to this ranking; to study one niche, rank its products with product_top_selling and read product with method=video_sales. Pass a row's id to video.

TokConnect REST: GET /v1/videos/top-selling

Inputs

No inputs beyond the shared ones.

Prompt

Sample call. MCP arguments:

{"region":"US","window":"7d"}

TokConnect's REST route for this call: GET /v1/videos/top-selling?region=US&window=7d. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "dataEnd": "2026-10-26",
  "window": {
    "days": 6,
    "end": "2026-10-26",
    "start": "2026-10-21"
  },
  "items": [
    {
      "id": "7698712372248104223",
      "description": "Tell me I'm not the only one who's bought way too many pillows. 😭👇 #Nuzzle #blackfriday #SleepUpgrade #stiffneck #sidesleeper",
      "revenue": "$113.49k",
      "sale": 3439,
      "views": "5.79m",
      "gpm": "$19.60",
      "ad_cpa": "$6.78",
      "ad2Roas": 3.89,
      "ad_revenue_ratio": "80.00%",
      "ai_video": 0,
      "duration": "5m 49s",
      "publish_date": "2026/10/20 14:20:00",
      "follower_count": "13.9k"
    }
  ]
}

live_top_selling: the top LIVE broadcasts

TokConnect lists the top 10 LIVE broadcasts by estimated revenue, with host, start and end time, duration, units, GPM and average price. The data source applies no filters. Pass a row's id to live with method set to products, sales or history.

TokConnect REST: GET /v1/lives/top-selling

Inputs

No inputs beyond the shared ones.

Prompt

Sample call. MCP arguments:

{"region":"US","window":"7d"}

TokConnect's REST route for this call: GET /v1/lives/top-selling?region=US&window=7d. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "dataEnd": "2026-10-26",
  "window": {
    "days": 7,
    "end": "2026-10-26",
    "start": "2026-10-20"
  },
  "items": [
    {
      "id": "7699061230417349407",
      "title": "DEALS FOR YOU - Live Now!",
      "revenue": "$174.88k",
      "sale": 5867,
      "views": "3.09m",
      "gpm": "$56.65",
      "unit_price": "$29.81",
      "duration": "123h 56m",
      "create_time": "2026/10/21 06:15:53",
      "finish_time": "2026/10/26 10:12:51",
      "record_type": "SHORT",
      "main_category": [
        "601450-848904"
      ]
    }
  ]
}

category_trends: category revenue, growth and concentration

TokConnect lists the top TikTok Shop categories by estimated revenue over the last 7 days of data, with growth, revenue per shop, top-3 and top-10 shop share and the split by video, LIVE and affiliate. method=tree returns category names and ids to pass as category to the ranking tools, and market_size counts what the source tracks in a market.

TokConnect REST: GET /v1/categories/top, GET /v1/categories/products, GET /v1/categories/search, GET /v1/categories/tree, GET /v1/categories/market-size

Inputs

Prompt

Sample call. MCP arguments:

{"method":"list","region":"US"}

TokConnect's REST route for this call: GET /v1/categories/top?region=US. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "dataEnd": "2026-10-26",
  "window": {
    "days": 7,
    "end": "2026-10-26",
    "start": "2026-10-20"
  },
  "items": [
    {
      "id": "601450",
      "name": "Beauty & Personal Care",
      "level": "1",
      "revenue": "$89.26m",
      "revenue_growth_rate": 0.038938999635497434,
      "shop_number": 15789,
      "top_3_shop_revenue_ratio": 0.10238266851357314,
      "top_10_shop_revenue_ratio": 0.18379483355838186,
      "video_revenue": "$60.06m",
      "live_revenue": "$17.03m",
      "affiliate_revenue": "$72.18m",
      "self_promotion_revenue": "$7.63m"
    }
  ]
}

Data: TokConnect category_trends, TikTok Shop US estimates for the 7 days to 26 October 2026, 5 of 10 rows. Open the data.

shop_regions: the 17 markets

TokConnect lists the TikTok Shop markets Shop Analytics covers, with each market's currency, language and tier: 13 core markets and 4 extended ones (PL, IT, NL, IE). Pass a code as region to any other Shop Analytics tool. Other countries are refused.

TokConnect REST: GET /v1/markets

Inputs

No inputs beyond the shared ones.

Prompt

Sample call. MCP arguments:

{}

TokConnect's REST route for this call: GET /v1/markets. Response, trimmed:

{
  "count": 17,
  "default": "US",
  "markets": [
    {
      "code": "US",
      "currency": "USD",
      "language": "en",
      "name": "United States",
      "tier": "core"
    },
    {
      "code": "GB",
      "currency": "GBP",
      "language": "en",
      "name": "United Kingdom",
      "tier": "core"
    }
  ],
  "notes": [
    "Pass a market's code as region to product_top_selling, shop_top_selling, creator_top_selling, video_top_selling, live_top_selling, category_trends, product, shop, creator_commerce, video or live (their Shop Analytics methods)."
  ]
}

product: one product, live and estimated

TokConnect reads one TikTok Shop product by id or product link: the live page (price, variants and stock, rating, shop and TikTok's lifetime sold counter) and, in any of the 17 markets, estimated sales, daily trend, the creators and videos selling it, sales by variant, selling points, creator conversion and review insights. method=sales also takes ids, up to 20 product ids in one call.

TokConnect REST: 12 routes, listed in the table. The sample uses GET /v1/products/{id}/sales.

Inputs

Prompt

Sample call. MCP arguments:

{"id":"1732277424593932739","method":"sales","region":"US","window":"30d"}

TokConnect's REST route for this call: GET /v1/products/1732277424593932739/sales?region=US&window=30d. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "id": "1732277424593932739",
  "dataEnd": "2026-10-26",
  "window": {
    "days": 30,
    "end": "2026-10-26",
    "start": "2026-09-27"
  },
  "creatorConversion": {
    "creatorConversionRatio": 0.2413223140495868,
    "creatorNum": 605
  },
  "totals": {
    "revenue": "$655.71k",
    "sale": "5.08k",
    "unit_price": "$129.00",
    "video_revenue": "$527.61k",
    "live_revenue": "$127.84k",
    "shopping_mall_revenue": "$258.00",
    "day_revenue": "$23.42k",
    "day_sale": "181.54",
    "related_creator_count": 147
  }
}

TokConnect's creators method answers who sells a product. These are the top 5 creators of the top cat litter box listing, masked:

Data: TokConnect product with method=creators, REST GET /v1/products/{id}/creators, 30 days to 26 October 2026. Open the data.

shop: one seller

TokConnect reads one TikTok Shop seller by sellerId, which you get from shop_top_selling or from any product. It returns the live storefront and, in any market, estimated revenue split across own accounts, affiliates and the mall, daily trend, products, new products, price bands and channel mix, affiliate creators, videos, and the daily count of new affiliates and affiliate videos.

TokConnect REST: 10 routes, listed in the table. The sample uses GET /v1/shops/{id}/sales.

Inputs

Prompt

Sample call. MCP arguments:

{"id":"7495791587377711555","method":"sales","region":"US","window":"30d"}

TokConnect's REST route for this call: GET /v1/shops/7495791587377711555/sales?region=US&window=30d. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "id": "7495791587377711555",
  "dataEnd": "2026-10-26",
  "window": {
    "days": 30,
    "end": "2026-10-26",
    "start": "2026-09-27"
  },
  "totals": {
    "revenue": "$1.60m",
    "sale": "17.01k",
    "unit_price": "$94.28",
    "video_revenue": "$1.10m",
    "live_revenue": "$483.45k",
    "showcase_revenue": "$18.23k",
    "affiliate_revenue": "$1.36m",
    "affiliate_percentage": 84.91,
    "self_promotion_revenue": "$236.60k",
    "self_promotion_percentage": 14.75,
    "shopping_mall_revenue": "$5.36k",
    "shopping_mall_percentage": 0.33
  }
}

creator_commerce: what one creator sells

TokConnect reads what one creator sells: products linked in recent posts, and in any market the estimated sales, daily trend, the products and shops they sell for, their selling videos and audience. Use it to vet an affiliate. id takes an @handle, a profile or video link, a secUid or a numeric user id, and the numeric id from any Shop Analytics row needs no lookup. The sample reads a brand's own account.

TokConnect REST: 7 routes, listed in the table. The sample uses GET /v1/creators/{id}/shop/products.

Inputs

Prompt

Sample call. MCP arguments:

{"id":"7362120151982048298","method":"products","region":"US","window":"30d","limit":5}

TokConnect's REST route for this call: GET /v1/creators/7362120151982048298/shop/products?region=US&window=30d&limit=5. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "id": "7362120151982048298",
  "dataEnd": "2026-10-26",
  "window": {
    "days": 30,
    "end": "2026-10-26",
    "start": "2026-09-27"
  },
  "items": [
    {
      "id": "1729543332241248707",
      "product_title": "PetPivot AutoScooper 11 Open-Top Automatic Self-Cleaning Cat Litter Box - Pull & Wrap, Odor-Free, Sealed Drawer Odor Traps, Up to 14 Days Scoop-Free, 6.5L/1.72Gal & 7L/1.85Gal Capacities, Limited-Time 80 Total Waste Bags (Extra 60 Included), Sohochic",
      "revenue": "$53.07k",
      "sale": "366",
      "unit_price": "$145.00",
      "seller_id": "7495791587377711555"
    },
    {
      "id": "1732443287626682819",
      "product_title": "PetPivot AutoScooper 12 Lite-Piece Value Bundle - Open-Top Automatic Litterbox, Low Entry Easy Access Kitten Litter Box with Step, 4 Rolls (80 Waste Bags), Odor Control, Low Entry Litter Box, SohoChic",
      "revenue": "$33.07k",
      "sale": "212",
      "unit_price": "$156.00",
      "seller_id": "7495791587377711555"
    }
  ]
}

video: one video, and the revenue it drove

TokConnect reads one TikTok video or photo post by link or post id. Its Shop Analytics methods return the revenue, units and ad metrics the video drove, the products it sold, the daily sales of those products and how similar videos performed. The tool also reads the post itself: detail, comments, replies, caption transcript and similar videos.

TokConnect REST: 4 Shop Analytics routes, listed in the table. The sample uses GET /v1/videos/{id}/sales.

Inputs

Prompt

Sample call. MCP arguments:

{"id":"7698712372248104223","method":"sales","region":"US","window":"7d"}

TokConnect's REST route for this call: GET /v1/videos/7698712372248104223/sales?region=US&window=7d. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "id": "7698712372248104223",
  "dataEnd": "2026-10-26",
  "window": {
    "days": 7,
    "end": "2026-10-26",
    "start": "2026-10-20"
  },
  "totals": {
    "revenue": "$113.52k",
    "sale": "3.44k",
    "views": "5.79m",
    "new_followers": "5.21k",
    "day_revenue": "$16.22k",
    "day_sale": "491.43"
  },
  "ads": {
    "ad2Cost": "$23.33k",
    "ad2Roas": 3.89,
    "ad_revenue_ratio": "80.00%",
    "ad_view_ratio": "9.20%"
  }
}

live: one LIVE room

TokConnect reads one LIVE room by id from live_search or live_top_selling. In any market its Shop Analytics methods return the revenue, units, duration and viewers, the performance over the broadcast, the products sold with revenue, price bands, top categories and recording URLs. The now method reads the live status.

TokConnect REST: 6 Shop Analytics routes, listed in the table. The sample uses GET /v1/lives/{id}/products.

Inputs

Prompt

Sample call. MCP arguments:

{"id":"7699061230417349407","method":"products","region":"US","limit":5}

TokConnect's REST route for this call: GET /v1/lives/7699061230417349407/products?region=US&limit=5. Response, trimmed:

{
  "market": "US",
  "currency": "USD",
  "id": "7699061230417349407",
  "dataEnd": "2026-10-26",
  "window": {
    "days": 30,
    "end": "2026-10-26",
    "start": "2026-09-27"
  },
  "items": [
    {
      "id": "1731944290169033014",
      "product_title": "BASED Ultimate Skin Set | Under Eye Elixir, Daily Cleanser, Daily Moisturizer, Skin Revival Spray, White Face Towel | Simple, Effective, Based.",
      "revenue": "$13.53k",
      "sale": "246",
      "unit_price": "$55.00"
    },
    {
      "id": "1732307769700553014",
      "product_title": "BASED Deluxe Straight/Wavy Hair Kit | Shampoo, Conditioner, Texture Powder, Hair Clay, Pomade, Sea Salt Spray + Wooden Comb | Science-Backed, High Performance",
      "revenue": "$12.60k",
      "sale": "180",
      "unit_price": "$70.00"
    }
  ]
}

What do errors and credits look like?

TokConnect charges 1 credit for each call that answers, refunds a call that fails, and never charges a refused one. Over REST a refusal is a real HTTP status (402 out of credits, 403 plan, 429 rate limit, 502 source failed, 503 busy); over MCP it arrives as an in-band error your AI can read. The status table, the plan limits and the per-plan credits are on the TikTok Shop data API page, and plan prices are on the pricing page. New to the data itself? Live TikTok Shop sales data in your AI assistant shows what to ask, and the TikTok Shop analytics API for n8n, Make and Zapier wires these routes into workflows.

A few inputs trip up first calls to TokConnect. keyword on shop_top_selling matches shop names, not product types, so rank products first and read the seller id from a product. category accepts names or numeric ids from category_trends with method=tree. And without a keyword, the ranking tools return their fixed top 10 for the latest days, whatever window you pass.

How we got these numbers

On 29 October 2026 we pulled TokConnect's live tool list from its production MCP server and called one tool of each kind there: product_top_selling, shop_top_selling, creator_top_selling, video_top_selling, live_top_selling, category_trends, shop_regions, and product, shop, creator_commerce, video and live with one Shop Analytics method each. Input names, types, values and routes on this page are generated from that tool list and from the TokConnect API server's route table, so they match what your AI and your code see.

Windows are 30 days (27 September to 26 October 2026) for most calls, 7 days (20 to 26 October) for the video, LIVE and category calls, and the latest 6 days where a ranking has no keyword. Revenue and units are TokConnect Shop Analytics estimates: units track TikTok's sold counter and revenue is units times the listed price. Amounts are in USD for the US market. Individual creators are masked, and only a brand's own account keeps its label. Samples are trimmed to the fields shown, with values unchanged. Data: evidence file.