TikTok Shop
TikTok Creative Detail
TikTok Creative Detail
MCP tool name
nexscope_chuhaijiang_tiktok_creative_detailMCP endpoint
https://api.nexscope.ai/api/skill-api/v2/mcpJSON-RPC method
tools/callTikTok Shop
TikTok Creative Detail
nexscope_chuhaijiang_tiktok_creative_detailhttps://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-creative-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_creative_detail",
"arguments": {
"country": "us",
"id": "7668708053428047118",
"include": "analysis,embedding"
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/chuhaijiang-tiktok-creative-detailProgress 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 request market. Returned country_code may differ; preserve both. Example: us |
id | string | required | Creative ID returned by its search operation. Keep identifiers as strings to avoid precision loss. Example: 7668708053428047118 |
include | string | optional | Comma-separated expansions: analysis, embedding. Request only needed expansions. Example: analysis,embedding |
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 | optional | Request id 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 |
{
"country": "us",
"id": "7668708053428047118",
"include": "analysis,embedding"
}{
"data": {
"data": {
"items": []
}
},
"code": 0,
"msg": "ok",
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}string |
| optional |
Creative author and product identity: id. |
data.data.items[].video_id | string | optional | Creative author and product identity: video id. |
data.data.items[].uid | string | optional | Creative author and product identity: uid. |
data.data.items[].unique_id | string | optional | Creative author and product identity: unique id. |
data.data.items[].nickname | string | optional | Creative author and product identity: nickname. |
data.data.items[].share_url | string | optional | Creative author and product identity: share url. |
data.data.items[].product_id | string | optional | Creative author and product identity: product id. |
data.data.items[].product_name | string | optional | Creative author and product identity: product name. |
data.data.items[].follower_count | integer | optional | Author follower count: follower count. |
data.data.items[].video_30d_gpm | any | optional | Provider 30-day video GPM; preserve its original unit and runtime type. |
data.data.items[].video_comment_count | any | optional | Provider video comment count. |
data.data.items[].product_rating | any | optional | Provider product rating. |
data.data.items[].floor_price | any | optional | Provider lower product price; preserve its currency object and runtime type. |
data.data.items[].video_engagement_rate | any | optional | Provider video engagement rate. |
data.data.items[].product_l1_category | any | optional | First-level product category. |
data.data.items[].product_l2_category | any | optional | Second-level product category. |
data.data.items[].commission_rate | any | optional | Provider commission rate. |
data.data.items[].product_l3_category | any | optional | Third-level product category. |
data.data.items[].product_images | any | optional | Provider product images. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].video_30d_gmv | any | optional | Provider 30-day video GMV; preserve its original unit and runtime type. |
data.data.items[].video_play_count | any | optional | Provider video play count. |
data.data.items[].product_status | any | optional | Provider product status. |
data.data.items[].video_like_count | any | optional | Provider video like count. |
data.data.items[].video_collect_count | any | optional | Provider video collect count. |
data.data.items[].product_gmv | any | optional | Provider product GMV; preserve its original unit and runtime type. |
data.data.items[].product_sold_count | any | optional | Provider product sales count. |
data.data.items[].ceiling_price | any | optional | Provider upper product price; preserve its currency object and runtime type. |
data.data.items[].video_share_count | any | optional | Provider video share count. |
data.data.analysis | object | optional | Analysis value used by this API operation. |
data.data.analysis.items | array | optional | Items value used by this API operation. |
data.data.analysis.items[] | object | required | Item in data data analysis items. |
data.data.analysis.items[].id | string | optional | Creative analysis identifier or classification: id. |
data.data.analysis.items[].video_id | string | optional | Creative analysis identifier or classification: video id. |
data.data.analysis.items[].video_uri | string | optional | Creative analysis identifier or classification: video uri. |
data.data.analysis.items[].country_code | string | optional | Creative analysis identifier or classification: country code. |
data.data.analysis.items[].platform | string | optional | Creative analysis identifier or classification: platform. |
data.data.analysis.items[].hook_type | string | optional | Creative analysis identifier or classification: hook type. |
data.data.analysis.items[].hook_subtype | string | optional | Creative analysis identifier or classification: hook subtype. |
data.data.analysis.items[].formula_type | string | optional | Creative analysis identifier or classification: formula type. |
data.data.analysis.items[].formula_subtype | string | optional | Creative analysis identifier or classification: formula subtype. |
data.data.analysis.items[].angle_type | string | optional | Creative analysis identifier or classification: angle type. |
data.data.analysis.items[].angle_subtype | string | optional | Creative analysis identifier or classification: angle subtype. |
data.data.analysis.items[].is_aigc_video | boolean | optional | Provider AIGC flag: is aigc video. |
data.data.analysis.items[].video_cover | any | optional | Creative video cover media; preserve the provider representation. |
data.data.analysis.items[].transcription_with_structure | any | optional | Creative transcription with provider structural annotations; preserve its original JSON representation. |
data.data.analysis.items[].storyboards | any | optional | Creative storyboard and scene analysis; preserve the returned structure. |
data.data.embedding | object | optional | Embedding value used by this API operation. |
data.data.embedding.items | array | optional | Items value used by this API operation. |
data.data.embedding.items[] | object | required | Item in data data embedding items. |
data.data.embedding.items[].id | string | optional | Creative embedding identity: id. |
data.data.embedding.items[].video_id | string | optional | Creative embedding identity: video id. |
data.data.embedding.items[].video_uri | string | optional | Creative embedding identity: video uri. |
data.data.embedding.items[].country_code | string | optional | Creative embedding identity: country code. |
data.data.embedding.items[].platform | string | optional | Creative embedding identity: platform. |
data.data.embedding.items[].embedding | array | optional | Numeric embedding vector; returned only when requested. Avoid inlining the vector in summaries. |
data.data.embedding.items[].embedding[] | number | required | Item in data data embedding items[] embedding. |
data.data.embedding.items[].matched_tags | any | optional | Tags matched during creative embedding analysis; preserve the provider representation. |
data.data.embedding.items[].extracted_content | any | optional | Content extracted for creative similarity analysis; preserve the provider representation. |
data.data.embedding.items[].video_cover | any | optional | Creative video cover media; preserve the provider representation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |