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://claw-callback.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": {
      "pageSize": 10,
      "orderby": {
        "order": "desc",
        "field": "units_sold"
      },
      "dateInfo": {
        "value": "2026-08-01",
        "type": "day"
      },
      "page": 1,
      "region": "US"
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.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

NameTypeRequiredMeaning
regionstringrequired
Market region code. Options: US (United States), GB (United Kingdom), MX (Mexico), ES (Spain), ID (Indonesia), VN (Vietnam), MY (Malaysia), TH (Thailand), PH (Philippines)
Example: US
dateInfoobjectrequired
Date specification object, containing type and value fields
Example: { "value": "2026-08-01", "type": "day" }
dateInfo.typestringrequired
Time granularity: day, week, month
Example: day
dateInfo.valuestringrequired
Date value: day format YYYY-MM-DD, week format YYYY-weekNumber (e.g., 2025-18), month format YYYY-MM
Example: 2026-01-01
categorystringoptional
Product category name (English), matched to TikTok category ID. Non-English input must be translated to English first
Example: {}
orderbyobjectoptional
Sort rule object, containing field and order fields
Example: { "order": "desc", "field": "units_sold" }
orderby.fieldstringoptional
Sort field: units_sold (sales), gmv (GMV), total_units_sold (total sales), total_gmv (total GMV), growth_rate (growth rate)
Example: units_sold
orderby.orderstringoptional
Sort direction: desc (descending), asc (ascending), default desc
Example: desc
pageintegeroptional
Page number, default 1
Example: 1
pageSizeintegeroptional
Items per page, max 10, default 10
Example: 10

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
totalintegeroptional
Record count
Example: 1
productsarrayoptional
Hot selling product list (see product object below)
Example: []
columnsarrayoptional
Rendered columns
Example: []
typestringoptional
Render style
Example: {}
costTokenintegeroptional
Token cost
Example: 1
products[].titlestringoptional
Product name
Example: {}
products[].productIdstringoptional
Product ID
Example: example-id
products[].regionstringoptional
Region code
Example: US
products[].pricenumberoptional
Product price
Example: 1
products[].minPricenumberoptional
Minimum price
Example: 1
products[].maxPricenumberoptional
Maximum price
Example: 1
products[].currencystringoptional
Currency
Example: {}
products[].totalSaleCntintegeroptional
Total sales
Example: 1
products[].totalSale1dCntintegeroptional
Sales in last 1 day (returned when dateType=day)
Example: 1
products[].totalSale7dCntintegeroptional
Sales in last 7 days (returned when dateType=week)
Example: 1
products[].totalSale30dCntintegeroptional
Sales in last 30 days (returned when dateType=month)
Example: 1
products[].totalSaleGmvAmtnumberoptional
Total GMV
Example: 1
products[].totalSaleGmv1dAmtnumberoptional
GMV in last 1 day (returned when dateType=day)
Example: 1
products[].totalSaleGmv7dAmtnumberoptional
GMV in last 7 days (returned when dateType=week)
Example: 1
products[].totalSaleGmv30dAmtnumberoptional
GMV in last 30 days (returned when dateType=month)
Example: 1
products[].growthRatenumberoptional
Growth rate (percentage)
Example: 1
products[].shopNamestringoptional
Store name
Example: {}
products[].shopTotalUnitsSoldintegeroptional
Store total sales
Example: 1
products[].shopSellerIdstringoptional
Store seller ID
Example: example-id
products[].categoryNamestringoptional
Product category
Example: {}
products[].productCommissionRatenumberoptional
Product commission rate (basis points, 1000=10%)
Example: 1
products[].imageUrlstringoptional
Product image URL
Example: https://example.com/image.jpg
products[].offShelvesTextstringoptional
Whether delisted ("Yes"=delisted, "No"=on sale)
Example: {}
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

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

Example structuredContent

{
  "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
}