TikTok / Social Commerce

Tiktok Creator Analytics

Search TikTok e-commerce creator leaderboards via Kalodata and query detailed profiles for specific creators. Supports viewing top-performing influencer-sellers by region, currency, language, and date range, and using creatorId to retrieve follower count, video/live revenue and GPM, contact information, and associated shops. Trigger when users mention TikTok creator search, TikTok creator ranking, TikTok influencer leaderboard, TikTok creator detail, TikTok creator profile, creator homepage data, creator contact info, TikTok creator search, TikTok creator ranking, TikTok influencer leaderboard, TikTok creator detail, creator analytics, kalodata creator search/detail. Even if the user does not explicitly mention "kalodata", trigger this skill whenever their need involves viewing TikTok creator leaderboards or detailed sales performance data for a specific TikTok creator.

post/api/skill-api/v1/skills/tiktok-creator-analytics/run

Request

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

regionstring

Region/market code, e.g., US

dateRangestring

Time range, e.g., last7Day, last30Day

pageNumberinteger

Rank requests only: page number 1-5; detail requests are unaffected. Finite numeric strings and optional null remain accepted for compatibility.

pageSizeinteger

Rank requests only: items per page 5-100; detail requests are unaffected. Finite numeric strings and optional null remain accepted for compatibility.

languagestring

Return language, e.g., zh-CN, en-US

currencystring

Currency unit, e.g., USD

sortFieldobject

Sort criteria; pass an empty object {} for default rank order when not sorting

shop_idstring

Shop ID filter

revenue_rangestring

Revenue / GMV range filter

creator_typestring

Creator type filter

followers_rangestring

Follower range filter

engagement_ratestring

Engagement-rate filter

creatorIdstring

Creator unique ID, e.g., 7153432386608251946, obtainable from the creator_id in the creator rank response

Example request

{
  "region": "US",
  "dateRange": "last30Day",
  "pageNumber": 1,
  "pageSize": 10,
  "sortField": {},
  "category_ids": [],
  "creatorId": "68616495085350913"
}

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": {
    "data": [],
    "costToken": 1
  }
}

Changes

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