TikTok / Social Commerce

Tiktok Product Search

Search and analyze TikTok product data including sales, influencer sales data, pricing, and commission rates across 16 TikTok Shop sites. Trigger when users mention TikTok product search, TikTok Shop product analysis, TikTok sales data, influencer sales, TikTok product selection, TikTok commission rate, TikTok product ranking, Nexscope data query, TikTok product search, TikTok sales, influencer sales, TikTok commission, TikTok product selection, short-video e-commerce, TikTok data. Even if the user does not explicitly mention "Nexscope" or "TikTok", trigger this skill whenever their need involves searching products on TikTok Shop or analyzing TikTok product performance metrics.

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

Request

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

Product keyword (please translate to the local language). Max length 1000

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)

categoryKeywordCNstring

Product category (please enter in Chinese). Max length 1000

minTotalSaleCntinteger

Total sales (minimum)

maxTotalSaleCntinteger

Total sales (maximum)

minTotalSale30dCntinteger

30-day sales (minimum)

maxTotalSale30dCntinteger

30-day sales (maximum)

minTotalSaleGmvAmtstring

Product total GMV (minimum). Max length 1000

maxTotalSaleGmvAmtstring

Product total GMV (maximum). Max length 1000

minTotalSaleGmv30dAmtstring

Product total GMV (30-day) (minimum). Max length 1000

maxTotalSaleGmv30dAmtstring

Product total GMV (30-day) (maximum). Max length 1000

minSpuAvgPricenumber

SPU average price (minimum)

maxSpuAvgPricenumber

SPU average price (maximum)

minProductRatingnumber

Product rating (minimum)

maxProductRatingnumber

Product rating (maximum)

minReviewCountinteger

Review count (minimum)

maxReviewCountinteger

Review count (maximum)

minProductCommissionRatenumber

Product commission rate (minimum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05

maxProductCommissionRatenumber

Product commission rate (maximum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05

minTotalIflCntinteger

Promoting creator count (minimum)

maxTotalIflCntinteger

Promoting creator count (maximum)

minTotalVideoCntinteger

Promotional video count (minimum)

maxTotalVideoCntinteger

Promotional video count (maximum)

minTotalViewsCntinteger

Promotional view count (minimum)

maxTotalViewsCntinteger

Promotional view count (maximum)

minFirstCrawlDtinteger

Product listing time (minimum), format YYYYMMDD (e.g., 20200101 represents 2020-01-01)

maxFirstCrawlDtinteger

Product listing time (maximum), format YYYYMMDD

saleDaysinteger

Days the product has been on sale, unit is days

productSortFieldinteger

Sort field: 1=total sales, 2=total GMV, 3=SPU average price, 4=7-day sales, 5=30-day sales, 6=7-day GMV, 7=30-day GMV. Default 1

sortTypeinteger

Sort direction: 0=ascending, 1=descending. Default 1

pageNuminteger

Page number. Default 1

pageSizeinteger

Items per page. Default 50

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.