TikTok Shop
TikTok Ad Detail. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.
nexscope_chuhaijiang_tiktok_ad_detail/api/skill-api/v1/mcptools/callSend the user API key as a bearer token on every MCP JSON-RPC request.
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.
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-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_ad_detail",
"arguments": {
"country": "us",
"id": "7658119807128046879",
"include": "core"
}
}
}POST /api/skill-api/v1/mcphttps://www.nexscope.ai/mcp-map/chuhaijiang-tiktok-ad-detail| 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 |
include | string | optional | Comma-separated expansions: core. Request only needed expansions. Example: core |
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": "7658119807128046879",
"include": "core"
}{
"data": {
"data": {
"items": []
}
},
"code": 0,
"msg": "ok",
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}string |
| optional |
Ad identity and copy: id. |
data.data.items[].ad_title | string | optional | Ad identity and copy: ad title. |
data.data.items[].advertiser_id | string | optional | Ad identity and copy: advertiser id. |
data.data.items[].advertiser_name | string | optional | Ad identity and copy: advertiser name. |
data.data.items[].ad_url | string | optional | Ad identity and copy: ad url. |
data.data.items[].web_url | string | optional | Ad identity and copy: web url. |
data.data.items[].button_text | string | optional | Ad identity and copy: button text. |
data.data.items[].advertiser_avatar | object | optional | Provider image object: advertiser avatar. |
data.data.items[].ad_cover | object | optional | Provider image object: ad cover. |
data.data.items[].duration | integer | optional | Provider time or duration; preserve original units: duration. |
data.data.items[].ad_create_time | integer | optional | Provider time or duration; preserve original units: ad create time. |
data.data.items[].create_time | integer | optional | Provider time or duration; preserve original units: create time. |
data.data.items[].last_update_time | integer | optional | Provider time or duration; preserve original units: last update time. |
data.data.core | object | optional | Core value used by this API operation. |
data.data.core.items | array | optional | Items value used by this API operation. |
data.data.core.items[] | object | required | Item in data data core items. |
data.data.core.items[].id | string | optional | Core ad identity or provider ad type: id. |
data.data.core.items[].core_creative_id | string | optional | Core ad identity or provider ad type: core creative id. |
data.data.core.items[].core_ad_type | string | optional | Core ad identity or provider ad type: core ad type. |
data.data.core.items[].core_ad_day_count | integer | optional | Core ad performance count: core ad day count. |
data.data.core.items[].core_total_sc | integer | optional | Core ad performance count: core total sc. |
data.data.core.items[].core_video_play_count | integer | optional | Core ad performance count: core video play count. |
data.data.core.items[].core_video_like_count | integer | optional | Core ad performance count: core video like count. |
data.data.core.items[].core_video_comment_count | integer | optional | Core ad performance count: core video comment count. |
data.data.core.items[].core_video_share_count | integer | optional | Core ad performance count: core video share count. |
data.data.core.items[].core_video_collect_count | integer | optional | Core ad performance count: core video collect count. |
data.data.core.items[].core_ad_play_ratio | number | optional | Provider ratio or score; preserve original metric definition: core ad play ratio. |
data.data.core.items[].core_ad_gmv_ratio | number | optional | Provider ratio or score; preserve original metric definition: core ad gmv ratio. |
data.data.core.items[].core_ad_roas | number | optional | Provider ratio or score; preserve original metric definition: core ad roas. |
data.data.core.items[].core_video_popularity | number | optional | Provider ratio or score; preserve original metric definition: core video popularity. |
data.data.core.items[].core_ad_maximum_cost | object | optional | Provider monetary metric; preserve original unit and value: core ad maximum cost. |
data.data.core.items[].core_total_gmv | object | optional | Provider monetary metric; preserve original unit and value: core total gmv. |
data.data.core.items[].core_video_gpm_30d | object | optional | Provider monetary metric; preserve original unit and value: core video gpm 30d. |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |