TikTok / Social Commerce

Tiktok Product Discovery

Search and filter TikTok global e-commerce products based on FastMoss data, supporting keyword search, multi-dimensional filtering (category, shop type, commission rate, sales, creator count, etc.) and sorting. Trigger when users mention TikTok product selection, TikTok product search, TikTok product data, TikTok creator sales, TikTok commission rate, TikTok bestseller tracking, TikTok GMV analysis, TikTok product search, TikTok product research, TikTok creator sales, TikTok commission rate, TikTok GMV analysis, FastMoss. Even if the user does not explicitly mention "FastMoss", trigger this skill whenever their need involves searching product data or analyzing product performance on TikTok.

post/api/skill-api/v1/skills/tiktok-product-discovery/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/tiktok-product-discovery/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

keywordstring

Search keyword (fuzzy match on product title)

regionstring

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)

categorystring

English category name, automatically matched to TikTok category ID. Non-English input must be translated to English first

shopTypeinteger

Store type: 1=local store, 2=cross-border store

isTopSellingboolean

Filter hot-selling products only

isNewListedboolean

Filter newly listed products only

isSshopboolean

Filter TikTok fully managed (S-shop) products only

isFreeShippingboolean

Filter free shipping products only

isLocalWarehouseboolean

Filter local warehouse shipping products only

unitsSoldRangeobject

Sales volume range filter, format: {"min": 100, "max": 5000}

commissionRateRangeobject

Commission rate range filter, format: {"min": 0.05, "max": 0.20} (decimal, 0.10=10%)

creatorCountRangeobject

Creator count range filter, format: {"min": 10, "max": 500}

orderFieldstring

Sort field: day7_units_sold (7-day sales), day7_gmv (7-day GMV), commission_rate (commission rate), total_units_sold (total sales), total_gmv (total GMV), creator_count (creator count). Default descending order

pageinteger

Page number, default 1

pageSizeinteger

Items per page, max 10, default 10

pageNumberinteger

Example request

{
  "region": "US",
  "pageSize": 10,
  "keyword": "phone case",
  "pageNumber": 1
}

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.