TikTok Shop
Query TikTok e-commerce product leaderboards via Kalodata and query detailed data for specific products. Supports viewing high-ranking/hot-selling products by region, currency, language, and date range, and using productId to retrieve price range, sales, revenue, commission rate, listing/delisting time, and owning shop.
nexscope_tiktok_product_analyticshttps://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": "tiktok-product-analytics-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_product_analytics",
"arguments": {
"pageNumber": 1,
"region": "US",
"sortField": {},
"dateRange": "last30Day",
"pageSize": 10,
"productId": "1732505564636812173"
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/tiktok-product-analyticsProgress 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 |
|---|---|---|---|
region | string | optional | TikTok Shop market region code, e.g., US. If not specified, defaults to the server default (usually US) Example: US |
dateRange | string | optional | Relative date range, e.g., last7Day, last30Day Example: last30Day |
currency | string | optional | Currency code, e.g., USD Example: {} |
language | string | optional | Return language, e.g., zh-CN, en-US Example: {} |
sortField | object | optional | Sort specification object; omitted to use default ranking Example: {} |
category_ids | array | optional | Category ID list filter Example: [] |
shop_id | string | optional | Shop ID filter Example: {} |
creator_id | string | optional | Creator ID filter Example: {} |
video_id | string | optional | Return products associated with the specified video Example: {} |
livestream_id | string | optional | Return products associated with the specified livestream Example: {} |
revenue_range | string | optional | Revenue / GMV range filter Example: {} |
is_affiliate | string | optional | Affiliate filter: PUBLIC_PLAN or NON_AFFILIATE Example: {} |
commission_rate | number | optional | Affiliate commission rate, e.g. 0.15 Example: {} |
is_tts_product | integer | optional | Fully managed product filter: 1 or 0 Example: {} |
unit_price_range | string | optional | Product unit-price range filter Example: {} |
pageNumber | integer | optional | Page number, range 1-5 Example: 1 |
pageSize | integer | optional | Items per page, range 5-100 Example: 10 |
productId | string | optional | TikTok product ID, e.g., 1729508370969629931 (string format, to avoid large integer precision loss), obtainable from the product_id in the product rank response Example: 1732505564636812173 |
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.data | array | optional | Rank or detail data Example: [] |
data.data[] | object | required | Item in data data. |
data.data[].product_id | string | optional | Product ID (string format, to avoid large integer precision loss); used as productId to query details Example: example-id |
data.data[].product_name | string | optional |
{
"pageNumber": 1,
"region": "US",
"sortField": {},
"dateRange": "last30Day",
"pageSize": 10,
"productId": "1732505564636812173"
}{
"data": {
"data": [
{
"product_id": "example-id",
"unit_price": 1,
"sales_volumn": 1,
"revenue": 1,
"video_revenue": 1,
"live_revenue": 1,
"showcase_revenue": 1,
"revenue_growth_rate": 1,
"commission_rate": 1,
"launch_date": "2026-01-01",
"product_shop_id": "example-id",
"pri_cate_id": "example-id",
"sec_cate_id": "example-id",
"ter_cate_id": "example-id",
"min_price": 1,
"max_price": 1,
"product_review_count": 1,
"video_number": 1,
"live_number": 1,
"shopping_mall_revenue": 1,
"creator_number": 1
}
],
"costToken": 1
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}Product title Example: null |
data.data[].unit_price | number | optional | Unit price (currency depends on region, e.g., US means USD) Example: 1 |
data.data[].sales_volumn | integer | optional | Sales volume (units). Note: the field name is spelled sales_volumn (as-is, not volume). Use this exact name when extracting with jq/ConvertFrom-Json Example: 1 |
data.data[].revenue | number | optional | Total revenue (GMV), = video_revenue + live_revenue + showcase_revenue Example: 1 |
data.data[].video_revenue | number | optional | Video channel revenue Example: 1 |
data.data[].live_revenue | number | optional | Livestream channel revenue Example: 1 |
data.data[].showcase_revenue | number | optional | Showcase/display channel revenue Example: 1 |
data.data[].revenue_growth_rate | number | optional | Revenue growth rate (percentage, e.g., 27.94 means 27.94%) Example: 1 |
data.data[].commission_rate | number | optional | Commission rate (percentage, e.g., 25.0 means 25%; not basis points) Example: 1 |
data.data[].launch_date | string | optional | Launch date (YYYY-MM-DD) Example: 2026-01-01 |
data.data[].product_region | string | optional | Product region/market (e.g., us) Example: null |
data.data[].product_shop_id | string | optional | Belonged shop ID Example: example-id |
data.data[].pri_cate_id | string | optional | Primary category ID Example: example-id |
data.data[].sec_cate_id | string | optional | Secondary category ID Example: example-id |
data.data[].ter_cate_id | string | optional | Tertiary category ID Example: example-id |
data.data[].min_price | number | optional | Minimum price (in the requested currency) Example: 1 |
data.data[].max_price | number | optional | Maximum price (in the requested currency) Example: 1 |
data.data[].product_review_count | integer | optional | Product review count Example: 1 |
data.data[].delivery_type | string | optional | Delivery method (e.g., local) Example: null |
data.data[].video_number | integer | optional | Associated video count Example: 1 |
data.data[].live_number | integer | optional | Associated livestream count Example: 1 |
data.data[].shopping_mall_revenue | number | optional | Mall revenue (in the requested currency) Example: 1 |
data.data[].creator_number | integer | optional | Associated creator count Example: 1 |
data.costToken | integer | optional | Tokens consumed for this call, typically 14000 Example: 1 |
data.type | string | optional | Provider-specific render or payload type. Example: null |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |