TikTok / Social Commerce

TikTok Creator Rankings

Queries creator rankings by region and date range.

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

Request

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

regionstring

Optional TikTok Shop market region.

dateRangestring

Relative date range.

pageNumberinteger

Page number, 1-5. Finite numeric strings and optional null remain accepted by the backend for compatibility.

pageSizeinteger

Rows per page, 5-100. Finite numeric strings and optional null remain accepted by the backend for compatibility.

currencystring

Currency code.

languagestring

Response language.

sortFieldobject

Optional provider sort object.

Example request

{
  "region": "US",
  "dateRange": "last30Day",
  "pageNumber": 1,
  "pageSize": 10,
  "currency": "USD",
  "language": "en-US",
  "sortField": {}
}

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": []
  }
}

Changes

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