TikTok Commerce Intelligence CJ

TikTok Shop Most Promoted

Discover TikTok shops ranked by promotion activity. Call the TikTok Shop Most Promoted API via REST or MCP from 38 credits per call.

MCP tool name

nexscope_chuhaijiang_tiktok_shop_rankings_most_promoted

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "chuhaijiang-tiktok-shop-rankings-most-promoted-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_chuhaijiang_tiktok_shop_rankings_most_promoted",
    "arguments": {
      "country": "us",
      "date": "20260824",
      "granularity": "daily",
      "pageSize": 10
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`country`	`string`	required	Lowercase TikTok market code. Example: us
`page`	`integer`	optional	Page number, starting at 1. Example: 1
`pageSize`	`integer`	optional	Maximum records per page. Example: 10
`date`	`string`	required	Ranking date in YYYYMMDD format. Example: 20260824
`granularity`	`string`	required	Ranking period. Example: daily
`category`	`string`	optional	Product category ID. Example: {}
`shopType`	`string`	optional	Provider shop type. Example: {}
`sort`	`string`	optional	Provider sort field and direction (field:asc or field:desc). Example: related_creator_count:desc

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`errcode`	`integer`	optional	200 means success Example: {}
`errmsg`	`string`	optional	`ok` on success Example: {}
`request_id`	`string`	optional	Request tracking ID Example: {}
`data`	`object`	optional	The list is at `data.items[]`, and the total is `data.total_count` Example: {}
`biz_type`	`string`	optional	Business type Example: {}
`interval_related_creator_count`	`number`	optional	Number of people associated with interval Example: {}
`interval_total_related_videos_count`	`number`	optional	Number of interval associated videos Example: {}

Examples

Example arguments

{
  "country": "us",
  "date": "20260824",
  "granularity": "daily",
  "pageSize": 10
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}