TikTok / Social Commerce

TikTok Shop Search

Provider business records for TikTok Shop Search. Known row fields: id, shop_name, region, shop_rating, shop_product_count, shop_total_sold_count, shop_total_gmv, shop_sold_count_for_last_7_days, shop_gmv_for_last_7_days. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.

post/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-search/run

Request

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

country'br' | 'de' | 'es' | 'fr' | 'gb' | 'id' | 'it' | 'jp' | 'mx' | 'my' | 'ph' | 'sg' | 'th' | 'us' | 'vn' required

Lowercase TikTok market code.

pageinteger

Page number, starting at 1.

pageSizeinteger

Maximum records per page.

keywordstring

Shop search keyword.

categorystring

Product category ID.

sellerTypestring

Provider-supported seller type.

sortstring

Provider sort field and direction (field:asc or field:desc).

minRatingnumber

Minimum shop rating.

maxRatingnumber

Maximum shop rating.

minSold7dnumber

Minimum 7-day sales.

maxSold7dnumber

Maximum 7-day sales.

minGmv7dnumber

Minimum 7-day GMV.

maxGmv7dnumber

Maximum 7-day GMV.

Example request

{
  "country": "us",
  "page": 1,
  "pageSize": 5,
  "keyword": "beauty",
  "sort": "gmv_7d:desc"
}

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

Changes

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