TikTok / Social Commerce

TikTok Creator Search

Provider business records for TikTok Creator Search. Known row fields: account_type, author_avg_engagement_rate, bio_email, category_label, country_code, ecom_video_avg_play_count, facebook_url, follower_count, follower_count_growth_for_last_7_days, has_live_product, has_shop_product, has_video_product, id, ins_id, live_30d_gmv, live_30d_gpm, nickname, product_category_label_list, total_favorited, total_video_live_30d_gmv, unique_id, user_avatar, user_sell_product_l3_category, video_30d_gmv, video_30d_gpm, video_avg_like_count, video_avg_play_count, video_total_like_count_to_follower_count_ratio, youtube_channel_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.

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

Request

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

Creator search keyword.

categorystring

Creator category.

hasContactboolean

Filter by availability of public contact information.

sortstring

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

minFollowersnumber

Minimum follower count.

maxFollowersnumber

Maximum follower count.

minGmv30dnumber

Minimum 30-day GMV.

maxGmv30dnumber

Maximum 30-day GMV.

minAvgViewsnumber

Minimum average view count.

maxAvgViewsnumber

Maximum average view count.

minEngagementnumber

Minimum engagement rate.

maxEngagementnumber

Maximum engagement rate.

Example request

{
  "country": "us",
  "page": 1,
  "pageSize": 5,
  "keyword": "beauty",
  "hasContact": true,
  "sort": "gmv_30d: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.