TikTok / Social Commerce

Tiktok New Product Rank

Discover trending new products across 16 TikTok Shop regional markets via Nexscope new product ranking data. Trigger when users mention TikTok new product rankings, TikTok hot-selling products, TikTok Shop bestsellers, short-video e-commerce product selection, TikTok new product discovery, cross-border TikTok product selection, TikTok new product rankings, TikTok bestsellers, short-video product selection, TikTok viral products, new product ranking, TikTok product trends. Even if the user does not explicitly mention "Nexscope" or "new product ranking", trigger this skill whenever their need involves discovering hot-selling new products or emerging product trends on TikTok Shop.

post/api/skill-api/v1/skills/tiktok-new-product-rank/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/tiktok-new-product-rank/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

datestring required

Date in YYYY-MM-DD format

regionstring

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)

pageNuminteger

Page number, default 1

pageSizeinteger

Items per page, default 50

Example request

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

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "total": 1,
    "products": [],
    "costToken": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.