TikTok Shop
TikTok Ad Related Products
TikTok Ad Related Products
MCP tool name
nexscope_chuhaijiang_tiktok_ad_related_productsMCP endpoint
https://api.nexscope.ai/api/skill-api/v2/mcpJSON-RPC method
tools/callAuthentication
Use 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.
Call this MCP 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-ad-related-products-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_ad_related_products",
"arguments": {
"id": "7658119807128046879",
"pageSize": 3,
"page": 1,
"country": "us"
}
}
}Protocol
MCP 2025-11-25 · Streamable HTTPCanonical detail URL
https://www.nexscope.ai/mcp-map/chuhaijiang-tiktok-ad-related-productsProgress 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.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
country | string | required | Lowercase request market. Returned country_code may differ; preserve both. Example: us |
id | string | required | Ad ID returned by its search operation. Keep identifiers as strings to avoid precision loss. Example: 7658119807128046879 |
page | integer | optional | Page number, starting at 1. No automatic pagination. Example: 1 |
pageSize | integer | optional | Items per page, from 1 to 10. Omission preserves the upstream default. Example: 3 |
Response fields
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. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.data | object | optional | Data value used by this API operation. |
data.data.items | array | optional | Items value used by this API operation. |
data.data.items[] | object | required | Item in data data items. |
data.data.items[].id | string | optional | Related product identity: id. |
data.data.items[].tiktok_product_detail_product_name | string | optional | Related product identity: tiktok product detail product name. |
data.data.items[].tiktok_product_detail_floor_price | object | optional | Price with original unit and value: tiktok product detail floor price. |
data.data.items[].tiktok_product_detail_ceiling_price | object | optional | Price with original unit and value: tiktok product detail ceiling price. |
data.data.items[].tiktok_product_detail_product_rating | number | optional | Provider product rating: tiktok product detail product rating. |
data.data.items[].tiktok_ads_detail_product_id | string | optional | Ad related product identity: tiktok ads detail product id. |
data.data.items[].tiktok_ads_detail_video_id | string | optional | Ad related product identity: tiktok ads detail video id. |
data.data.items[].tiktok_ads_detail_product_country_code | string | optional | Ad related product identity: tiktok ads detail product country code. |
data.data.items[].tiktok_ads_detail_product_total_sold_count | integer | optional | Ad attributed sales count: tiktok ads detail product total sold count. |
data.data.items[].tiktok_ads_detail_video_30d_sold_count | integer | optional | Ad attributed sales count: tiktok ads detail video 30d sold count. |
data.data.items[].tiktok_ads_detail_product_total_gmv | object | optional | GMV preserving original unit and value: tiktok ads detail product total gmv. |
data.data.items[].tiktok_ads_detail_video_30d_gmv | object | optional | GMV preserving original unit and value: tiktok ads detail video 30d gmv. |
data.data.items[].tiktok_product_detail_product_status | any | optional | Provider tiktok product detail product status. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].tiktok_product_detail_l2_category | any | optional | Provider tiktok product detail l2 category. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].tiktok_ads_detail_product_launch_time | any | optional | Provider tiktok ads detail product launch time. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].tiktok_product_detail_l3_category | any | optional | Provider tiktok product detail l3 category. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].tiktok_product_detail_product_images | any | optional | Provider tiktok product detail product images. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].tiktok_product_detail_product_sku_props | any | optional | Provider tiktok product detail product sku props. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].tiktok_product_detail_region | any | optional | Provider tiktok product detail region. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].tiktok_product_detail_product_skus | any | optional | Provider tiktok product detail product skus. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].tiktok_product_detail_commission_rate | any | optional | Provider tiktok product detail commission rate. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].tiktok_product_detail_l1_category | any | optional | Provider tiktok product detail l1 category. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.total_count | integer | optional | Total count value used by this API operation. |
data.request_id | string | optional | Request id value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Examples
Example arguments
{
"id": "7658119807128046879",
"pageSize": 3,
"page": 1,
"country": "us"
}Example structuredContent
{
"data": {
"data": {
"items": [],
"total_count": 0
}
},
"code": 0,
"msg": "ok",
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}