TikTok / Social Commerce

Tiktok Livestream Analytics

Search TikTok e-commerce livestream leaderboards via Kalodata and query detailed data for specific livestreams. Supports viewing high-ranking, high-sales TikTok shopping livestreams by region, currency, language, and date range, and using livestreamId to retrieve revenue, viewers, duration, GPM, and number of products sold. Trigger when users mention TikTok livestream ranking, TikTok live ranking, TikTok top livestreams, TikTok live shopping ranking, TikTok livestream detail, TikTok live data, live viewers, kalodata livestream search, kalodata livestream ranking, TikTok livestream ranking, TikTok live ranking, TikTok top livestreams, TikTok live shopping ranking, TikTok livestream detail, kalodata livestream search/detail, live analytics. Even if the user does not explicitly mention "kalodata", trigger this skill whenever their need involves viewing TikTok livestream leaderboards or detailed data for a specific TikTok livestream.

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

Request

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

dateRangestring

Time range, e.g., last7Day (last 7 days), last30Day (last 30 days). Max length 1000

pageNumberinteger

Page number, value range 1-5 (out of range returns errcode 501)

pageSizeinteger

Items per page, value range 5-100

languagestring

Return language, e.g., zh-CN, en-US. Max length 1000

currencystring

Currency unit, e.g., USD. Max length 1000

sortFieldobject

Sort criteria, structure defined by the gateway; pass an empty object {} for default rank order when not sorting

livestreamIdstring

Target livestream unique ID (camelCase), e.g., 7661409374878878494. Typically obtained from the livestream_id in the livestream rank endpoint. Max length 1000

category_idstring

Category ID filter

shop_idstring

Shop ID filter

creator_idstring

Creator ID filter

product_idstring

Product ID filter

followers_rangestring

Creator follower range filter

Example request

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

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.