TikTok / Social Commerce

TikTok Creator Commercial

Provider business records for TikTok Creator Commercial. Known row fields: bio_email, category_label, country_code, creator_oecuid, follower_count, handle, id, interval_ecom_video_play_count_growth, interval_live_user, interval_new_follower, l1_category_aggregated_live_gmv, l1_category_aggregated_total_gmv, l1_category_aggregated_video_gmv, nickname, product_count, titkok_creator_commercial_interval_live_gmv, titkok_creator_commercial_interval_total_video_live_gmv, titkok_creator_commercial_interval_video_gmv, uid, unique_id, user_avatar, user_sell_product_l1_category. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.

post/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-rankings-commercial/run

Request

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

sortstring

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

creatorCategorystring

Creator category.

productCategorystring

Product category.

Example request

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