TikTok / Social Commerce

TikTok New Product Rank MCP Tool

Discover trending new products across 16 TikTok Shop regional markets via EchoTik new product ranking data.

MCP tool name
nexscope_tiktok_new_product_rank
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-new-product-rank/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-new-product-rank-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_new_product_rank",
    "arguments": {
      "region": "US",
      "pageSize": 10,
      "pageNum": 1,
      "date": "2026-08-01"
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-new-product-rank/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/tiktok-new-product-rank

Arguments

NameTypeRequiredMeaning
datestringrequired
Date in YYYY-MM-DD format
Example: 2026-08-01
regionstringoptional
Region, default US. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)
Example: US
pageNumintegeroptional
Page number, default 1
Example: 1
pageSizeintegeroptional
Items per page, default 50
Example: 10

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
totalintegeroptional
Record count
Example: 1
productsarrayoptional
New 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[].asinstringoptional
Product ID
Example: B072MQ5BRX
products[].regionstringoptional
Region code
Example: US
products[].pricenumberoptional
SPU average 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[].totalSale30dCntintegeroptional
Sales in last 30 days
Example: 1
products[].totalSaleGmvAmtnumberoptional
Total GMV
Example: 1
products[].totalSaleGmv30dAmtnumberoptional
GMV in last 30 days
Example: 1
products[].salesTrendFlagTextstringoptional
Sales trend indicator, 0=stable 1=rising 2=falling
Example: {}
products[].totalVideoCntintegeroptional
Total video count
Example: 1
products[].totalLiveCntintegeroptional
Total livestream count
Example: 1
products[].totalIflCntintegeroptional
Total creator count
Example: 1
products[].productCommissionRatenumberoptional
Product commission rate
Example: 1
products[].productRatingnumberoptional
Product rating
Example: 1
products[].reviewCountintegeroptional
Review count
Example: 1
products[].availableDatestringoptional
First crawl date
Example: 2026-01-01
products[].categoryIdstringoptional
Product category ID
Example: example-id
products[].imageUrlstringoptional
Product image
Example: https://example.com/image.jpg
products[].productImageUrlsarrayoptional
Product image URL list
Example: []
products[].sourceToolstringoptional
Source tool
Example: {}
products[].sourceTypestringoptional
Product source
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

{
  "region": "US",
  "pageSize": 10,
  "pageNum": 1,
  "date": "2026-08-01"
}

Example structuredContent

{
  "total": 1,
  "products": [
    {
      "asin": "B072MQ5BRX",
      "region": "US",
      "price": 1,
      "minPrice": 1,
      "maxPrice": 1,
      "totalSaleCnt": 1,
      "totalSale30dCnt": 1,
      "totalSaleGmvAmt": 1,
      "totalSaleGmv30dAmt": 1,
      "totalVideoCnt": 1,
      "totalLiveCnt": 1,
      "totalIflCnt": 1,
      "productCommissionRate": 1,
      "productRating": 1,
      "reviewCount": 1,
      "availableDate": "2026-01-01",
      "categoryId": "example-id",
      "imageUrl": "https://example.com/image.jpg",
      "productImageUrls": []
    }
  ],
  "columns": [],
  "costToken": 1
}