TikTok / Social Commerce

TikTok Shop Most Promoted

Provider business records for TikTok Shop Most Promoted. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_related_creator_count, interval_total_related_creator_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.

post/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-rankings-most-promoted/run

Request

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

datestring required

Ranking date in YYYYMMDD format.

granularity'daily' | 'weekly' | 'monthly' | '0' | '1' | '2' required

Ranking period.

categorystring

Product category ID.

shopType'1' | '2' | '3' | '4'

Provider shop type.

sortstring

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

Example request

{
  "country": "us",
  "page": 1,
  "pageSize": 5,
  "date": "20260824",
  "granularity": "daily",
  "sort": "related_creator_count: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.