TikTok / Social Commerce

Tiktok Video Analytics

Search TikTok e-commerce trending promotional video leaderboards via Kalodata and query detailed data for specific videos. Supports viewing high-ranking/high-view/hot-selling promotional videos by region, currency, language, and date range, and using videoId to retrieve views, likes, comments, shares, revenue, GPM, and advertising metrics. Trigger when users mention TikTok video search, TikTok video ranking, TikTok viral video chart, TikTok video detail, video analytics, kalodata video search/detail. Even if the user does not explicitly mention "kalodata", trigger this skill whenever their need involves viewing TikTok trending promotional video leaderboards or detailed sales and engagement data for a specific TikTok video.

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

Request

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

Page number, value range 1-5

pageSizeinteger

Items per page, value range 5-100

languagestring

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

currencystring

Currency unit, e.g., USD

sortFieldobject

Sort criteria; omitted to use default rank order

videoIdstring

TikTok video ID, e.g., 7659161409279806734, obtainable from the video_id in the video rank response

category_idstring

Category ID filter

shop_idstring

Shop ID filter

creator_idstring

Creator ID filter

product_idstring

Product ID filter

revenue_rangestring

GMV range; response field revenue is total GMV

followers_rangestring

Creator follower range filter

ads_roasnumber

Advertising ROAS filter

Example request

{
  "sortField": {},
  "dateRange": "last30Day",
  "pageSize": 10,
  "pageNumber": 1,
  "region": "US",
  "videoId": "6768504823336815877"
}

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.