TikTok / Social Commerce

TikTok Top Selling Products MCP Tool

Query TikTok global e-commerce market top-selling product rankings via FastMoss data, supporting daily/weekly/monthly dimensions and category-level analysis.

MCP tool name

nexscope_tiktok_top_selling_products

Equivalent REST API path

https://api.nexscope.ai/api/skill-api/v1/skills/tiktok-top-selling-products/run

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

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

REST API equivalent

POST https://api.nexscope.ai/api/skill-api/v1/skills/tiktok-top-selling-products/run

Canonical detail URL

https://www.nexscope.ai/mcp-map/tiktok-top-selling-products

Arguments

Name	Type	Required	Meaning
`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: { "value": "2026-08-01", "type": "day" }
`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
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.total`	`integer`	optional	Record count Example: 1
`data.products`	`array`	optional	Hot selling product list (see product object below) Example: []
`data.columns`	`array`	optional	Rendered columns Example: []
`data.type`	`string`	optional	Render style Example: null
`data.costToken`	`integer`	optional	Token cost Example: 1
`data.products[].title`	`string`	optional	Product name Example: null
`data.products[].productId`	`string`	optional	Product ID Example: example-id
`data.products[].region`	`string`	optional	Region code Example: US
`data.products[].price`	`number`	optional	Product price Example: 1
`data.products[].minPrice`	`number`	optional	Minimum price Example: 1
`data.products[].maxPrice`	`number`	optional	Maximum price Example: 1
`data.products[].currency`	`string`	optional	Currency Example: null
`data.products[].totalSaleCnt`	`integer`	optional	Total sales Example: 1
`data.products[].totalSale1dCnt`	`integer`	optional	Sales in last 1 day (returned when dateType=day) Example: 1
`data.products[].totalSale7dCnt`	`integer`	optional	Sales in last 7 days (returned when dateType=week) Example: 1
`data.products[].totalSale30dCnt`	`integer`	optional	Sales in last 30 days (returned when dateType=month) Example: 1
`data.products[].totalSaleGmvAmt`	`number`	optional	Total GMV Example: 1
`data.products[].totalSaleGmv1dAmt`	`number`	optional	GMV in last 1 day (returned when dateType=day) Example: 1
`data.products[].totalSaleGmv7dAmt`	`number`	optional	GMV in last 7 days (returned when dateType=week) Example: 1
`data.products[].totalSaleGmv30dAmt`	`number`	optional	GMV in last 30 days (returned when dateType=month) Example: 1
`data.products[].growthRate`	`number`	optional	Growth rate (percentage) Example: 1
`data.products[].shopName`	`string`	optional	Store name Example: null
`data.products[].shopTotalUnitsSold`	`integer`	optional	Store total sales Example: 1
`data.products[].shopSellerId`	`string`	optional	Store seller ID Example: example-id
`data.products[].categoryName`	`string`	optional	Product category Example: null
`data.products[].productCommissionRate`	`number`	optional	Product commission rate (basis points, 1000=10%) Example: 1
`data.products[].imageUrl`	`string`	optional	Product image URL Example: https://example.com/image.jpg
`data.products[].offShelvesText`	`string`	optional	Whether delisted ("Yes"=delisted, "No"=on sale) Example: null
`data.title`	`string`	optional	Provider-specific response title. Example: null
`data.sourceType`	`string`	optional	Provider-specific source platform type. Example: null
`data.sourceTool`	`string`	optional	Provider-specific source tool name. Example: null
`data.costTime`	`integer`	optional	Execution time reported by the upstream provider. Example: null
`data.page`	`integer`	optional	Current page returned by the upstream provider. Example: null
`data.pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: null
`data.pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: null
`data.totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: null
`data.dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: null

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

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

Example structuredContent

{
  "data": {
    "total": 1,
    "products": [
      {
        "productId": "example-id",
        "region": "US",
        "price": 1,
        "minPrice": 1,
        "maxPrice": 1,
        "totalSaleCnt": 1,
        "totalSale1dCnt": 1,
        "totalSale7dCnt": 1,
        "totalSale30dCnt": 1,
        "totalSaleGmvAmt": 1,
        "totalSaleGmv1dAmt": 1,
        "totalSaleGmv7dAmt": 1,
        "totalSaleGmv30dAmt": 1,
        "growthRate": 1,
        "shopTotalUnitsSold": 1,
        "shopSellerId": "example-id",
        "productCommissionRate": 1,
        "imageUrl": "https://example.com/image.jpg"
      }
    ],
    "columns": [],
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}