TikTok Shop
TikTok Creative Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.
nexscope_chuhaijiang_tiktok_creative_search/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-creative-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_creative_search",
"arguments": {
"country": "us",
"page": 1,
"pageSize": 3
}
}
}POST /api/skill-api/v1/mcphttps://www.nexscope.ai/mcp-map/chuhaijiang-tiktok-creative-search| Name | Type | Required | Description |
|---|---|---|---|
country | string | required | Lowercase request market. Returned country_code may differ; preserve both. Example: us |
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 |
keyword | string | optional | Creative search keyword. Example: beauty |
category | string | optional | Provider-approved creative category. Example: |
hasProduct | boolean | optional | Whether products are associated. Example: true |
isSponsored | boolean | optional | Whether content is sponsored. Example: true |
isAigc | boolean | optional | Whether content is generated by AI. Example: true |
sort | string | optional | Provider-approved field followed by :asc or :desc. No complete field enum is published. Example: gmv: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 | 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",
"page": 1,
"pageSize": 3
}{
"data": {
"data": {
"items": [],
"total_count": 0
}
},
"code": 0,
"msg": "ok",
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}string |
| optional |
Creative identity and copy: id. |
data.data.items[].video_id | string | optional | Creative identity and copy: video id. |
data.data.items[].product_id | string | optional | Creative identity and copy: product id. |
data.data.items[].author_uid | string | optional | Creative identity and copy: author uid. |
data.data.items[].author_unique_id | string | optional | Creative identity and copy: author unique id. |
data.data.items[].author_nickname | string | optional | Creative identity and copy: author nickname. |
data.data.items[].video_desc | string | optional | Creative identity and copy: video desc. |
data.data.items[].country_code | string | optional | Creative identity and copy: country code. |
data.data.items[].platform | string | optional | Creative identity and copy: platform. |
data.data.items[].follower_cnt | integer | optional | Creative audience and engagement count: follower cnt. |
data.data.items[].video_play_count | integer | optional | Creative audience and engagement count: video play count. |
data.data.items[].video_like_count | integer | optional | Creative audience and engagement count: video like count. |
data.data.items[].video_comment_count | integer | optional | Creative audience and engagement count: video comment count. |
data.data.items[].video_share_count | integer | optional | Creative audience and engagement count: video share count. |
data.data.items[].video_collect_count | integer | optional | Creative audience and engagement count: video collect count. |
data.data.items[].video_engagement_rate | number | optional | Provider engagement ratio: video engagement rate. |
data.data.items[].video_30d_gmv | object | optional | Monetary metric with original unit and value: video 30d gmv. |
data.data.items[].video_total_gmv | object | optional | Monetary metric with original unit and value: video total gmv. |
data.data.items[].video_30d_gpm | object | optional | Monetary metric with original unit and value: video 30d gpm. |
data.data.items[].is_aigc_video | any | optional | Provider is aigc video. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].content_tag_v2 | any | optional | Provider content tag v2. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].video_launch_time | any | optional | Provider video launch time. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].video_date | any | optional | Provider video date. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].video_duration | any | optional | Provider video duration. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].content_intent | any | optional | Provider content intent. The source establishes this field name; preserve its runtime JSON type and missing values. |
data.data.items[].user_avatar | any | optional | Provider user avatar. 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. |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |