TikTok Shop
TikTok Shop Top Selling
TikTok Shop Top Selling with public market data.
MCP tool name
nexscope_chuhaijiang_tiktok_shop_rankings_top_sellingMCP endpoint
https://api.nexscope.ai/api/skill-api/v2/mcpJSON-RPC method
tools/callTikTok Shop
TikTok Shop Top Selling with public market data.
nexscope_chuhaijiang_tiktok_shop_rankings_top_sellinghttps://api.nexscope.ai/api/skill-api/v2/mcptools/callUse OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "chuhaijiang-tiktok-shop-rankings-top-selling-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_shop_rankings_top_selling",
"arguments": {
"country": "us",
"date": "20260824",
"granularity": "daily",
"pageSize": 10
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/chuhaijiang-tiktok-shop-rankings-top-sellingProgress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.
| 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: interval_sold_count:desc |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.request_id | string | null | optional | Request id value used by this API operation. |
data.data | object | null | optional | Data value used by this API operation. |
data.data.items | array | null | optional | Provider business records for TikTok Shop Top Selling. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_sold_count, interval_gmv, interval_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type. |
data.data.items[] | object | null | required |
{
"country": "us",
"date": "20260824",
"granularity": "daily",
"pageSize": 10
}{
"data": {
"data": {
"items": [
{
"id": null,
"seller_id": null,
"shop_name": null
}
]
}
},
"code": 0,
"msg": "ok",
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}Item in data data items. |
data.data.items[].id | any | optional | Source-documented id; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].seller_id | any | optional | Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].shop_name | any | optional | Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].region | any | optional | Source-documented region; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].shop_rating | any | optional | Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].shop_product_count | any | optional | Source-documented shop_product_count; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].seller_main_category | any | optional | Source-documented seller_main_category; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].seller_business_info | any | optional | Source-documented seller_business_info; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].seller_avatar | any | optional | Source-documented seller_avatar; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].biz_type | any | optional | Source-documented biz_type; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].interval_sold_count | any | optional | Source-documented interval_sold_count; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].interval_total_sold_count | any | optional | Source-documented interval_total_sold_count; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].interval_sold_count_growth_rate | any | optional | Source-documented interval_sold_count_growth_rate; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].interval_gmv | any | optional | Source-documented interval_gmv; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].interval_total_gmv | any | optional | Source-documented interval_total_gmv; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].interval_gmv_pop_growth_rate | any | optional | Source-documented interval_gmv_pop_growth_rate; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].interval_related_creator_count | any | optional | Source-documented interval_related_creator_count; may be absent or null. Preserve the provider value and original monetary units. |
data.data.items[].interval_total_related_creator_count | any | optional | Source-documented interval_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units. |
data.data.total_count | integer | null | optional | Total matching records. |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |