TikTok Intelligence FM

TikTok Top Selling Products

Query TikTok Shop top-selling product rankings by day, week, month, market, and category. Call via REST API or MCP from 15 credits per call.

MCP tool name

nexscope_tiktok_top_selling_products

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "tiktok-top-selling-products-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_top_selling_products",
    "arguments": {
      "dateInfo": {
        "type": "day",
        "value": "2026-08-01"
      },
      "orderby": {
        "field": "units_sold",
        "order": "desc"
      },
      "page": 1,
      "pageSize": 10,
      "region": "US"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`region`	`string`	required	Market region code. Options: US (United States), GB (United Kingdom), MX (Mexico), ES (Spain), DE (Germany), IT (Italy), FR (France), ID (Indonesia), VN (Vietnam), MY (Malaysia), TH (Thailand), PH (Philippines), BR (Brazil), JP (Japan), SG (Singapore) Example: US
`dateInfo`	`object`	required	Date specification object, containing type and value fields Example: { "type": "day", "value": "2026-08-01" }
`dateInfo.type`	`string`	required	Time granularity: day, week, month Example: day
`dateInfo.value`	`string`	required	Date value: day format YYYY-MM-DD, week format YYYY-weekNumber (e.g., 2025-18), month format YYYY-MM Example: 2026-01-01
`category`	`string`	optional	Product category name (English), matched to TikTok category ID. Non-English input must be translated to English first Example: {}
`orderby`	`object`	optional	Sort rule object, containing field and order fields Example: { "field": "units_sold", "order": "desc" }
`orderby.field`	`string`	optional	Sort field: units_sold (sales), gmv (GMV), total_units_sold (total sales), total_gmv (total GMV), growth_rate (growth rate) Example: units_sold
`orderby.order`	`string`	optional	Sort direction: desc (descending), asc (ascending), default desc Example: desc
`page`	`integer`	optional	Page number, default 1 Example: 1
`pageSize`	`integer`	optional	Items per page, max 10, default 10 Example: 10

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`errcode`	`integer`	optional	Business status code, `200` indicates success. Example: {}
`errmsg`	`string`	optional	Business status description. Example: {}
`page`	`integer`	optional	Current page number. Example: {}
`pageSize`	`integer`	optional	The current number of items per page. Example: {}
`total`	`integer`	optional	Number of records. Example: {}
`products`	`array`	optional	List of hot-selling products, product object fields are shown in the table below. Example: {}
`columns`	`array`	optional	Rendered columns. Example: {}
`type`	`string`	optional	Rendering style. Example: {}
`costTime`	`integer`	optional	Interface time spent (milliseconds). Example: {}
`costToken`	`integer`	optional	Consume token; some responses may be omitted. Example: {}
`matchedCategoryIdPath`	`string`	optional	Path to the matched category ID; may be returned when `category` is passed in. Example: {}
`matchedCategoryNamePath`	`string`	optional	Matched category name path; may be returned when `category` is passed in. Example: {}
`title`	`string`	optional	Product name. Example: {}
`productId`	`string`	optional	Product ID. Example: {}
`region`	`string`	optional	Area code. Example: {}
`price`	`number`	optional	Product price. Example: {}
`minPrice`	`number`	optional	Lowest price; only price range products are returned. Example: {}
`maxPrice`	`number`	optional	Highest price; only price range products are returned. Example: {}
`currency`	`string`	optional	Currency symbol or logo. Example: {}
`totalSaleCnt`	`integer`	optional	Total sales. Example: {}
`totalSale1dCnt`	`integer`	optional	Sales volume in the last 1 day (returned when `dateType=day`). Example: {}
`totalSale7dCnt`	`integer`	optional	Sales volume in the past 7 days (returned when `dateType=week`). Example: {}
`totalSale30dCnt`	`integer`	optional	Sales volume in the last 30 days (returned when `dateType=month`). Example: {}
`totalSaleGmvAmt`	`number`	optional	Total sales. Example: {}
`totalSaleGmv1dAmt`	`number`	optional	Sales in the last 1 day (returned when `dateType=day`). Example: {}
`totalSaleGmv7dAmt`	`number`	optional	Sales in the last 7 days (returned when `dateType=week`). Example: {}
`totalSaleGmv30dAmt`	`number`	optional	Sales in the last 30 days (returned for `dateType=month`). Example: {}
`growthRate`	`number`	optional	Growth rate (percent). Example: {}
`shopName`	`string`	optional	Store name. Example: {}
`shopTotalUnitsSold`	`integer`	optional	The total sales volume of the store. Example: {}
`shopSellerId`	`string`	optional	Store seller ID. Example: {}
`categoryName`	`string`	optional	Product category. Example: {}
`categoryIds`	`array`	optional	Product category ID path (level one to level three). Example: {}
`productCommissionRate`	`number`	optional	Product commission ratio (basis points, 1000=10%). Example: {}
`imageUrl`	`string`	optional	Product image URL. Example: {}
`coverUrl`	`array`	optional	Product cover image URL list. Example: {}
`shopAvatar`	`string`	optional	Store avatar URL. Example: {}
`sourceType`	`string`	optional	Product source type. Example: {}
`offShelvesText`	`string`	optional	Whether it is removed from the shelves ("Yes" = removed from the shelves, "No" = on sale). Example: {}

Examples

Example arguments

{
  "dateInfo": {
    "type": "day",
    "value": "2026-08-01"
  },
  "orderby": {
    "field": "units_sold",
    "order": "desc"
  },
  "page": 1,
  "pageSize": 10,
  "region": "US"
}

Example structuredContent

{}