TikTok Commerce Intelligence CJ
TikTok Creator Detail MCP
View a TikTok creator's profile for potential partnerships. Call the TikTok Creator Detail API via REST or MCP with your Nexscope API key.
TikTok Creator Detail AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Inspect A TikTok Creator’S Documented Profile And Commerce Data
Prompt: Inspect a TikTok creator’s documented profile and commerce data for [record ID] in [target marketplace]. Show the available results and clearly identify missing information.
2. Review Creator Commerce Content
Prompt: Look up TikTok creator [record ID] in [supported country] with core details. Show commerce-video count, average commerce-video views, likes-to-followers ratio and median commission rate, preserving the documented scales and missing values.
3. Review Creator Commerce And Audience Context
Prompt: Look up TikTok creator [record ID] in [supported country] with channel and audience-portrait details. Show the returned combined video-and-live GMV for 30 days, follower count and update time. Do not split combined GMV into channels or treat it as creator income.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_chuhaijiang_tiktok_creator_detailhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "chuhaijiang-tiktok-creator-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_creator_detail",
"arguments": {
"country": "us",
"id": "7302162228386776110",
"include": "core,channel,portrait"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
country | string | required | Lowercase TikTok market code. Example: us |
id | string | required | Creator ID, preserved as a string. Example: 7302162228386776110 |
include | string | optional | Comma-separated optional detail sections: core, channel, portrait. Example: core,channel,portrait |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
errcode | integer | optional | 200 means success |
errmsg | string | optional | Typically `ok` on success |
request_id | string | optional | Request tracking ID |
data | object | optional | Basic and optional extended data |
last_update_time | integer | optional | Last updated timestamp |
core_video_total_like_count_to_follower_count | number | optional | Likes to fans ratio |
tioktok_creator_detail_core_ec_video_count | number | optional | Number of e-commerce videos; retain `tioktok` spelling by source field |
tioktok_creator_detail_core_ecom_video_avg_play_count | number | optional | Average views of e-commerce videos |
tioktok_creator_detail_core_med_commission_rate | number | optional | Median commission rate |
channel_total_video_live_30d_gmv | object/number | optional | The total GMV of video and live broadcast in the past 30 days |
portrait_follower_count | number | optional | Number of fans based on portraits |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Show the commerce-video metrics and audience profile for TikTok creator 7302162228386776110 in the US.
Illustrative Response Explanation
The illustrative response reports 10 commerce videos averaging 1,000 views and a follower count of 5,000 in the audience-profile section. These figures do not establish conversion rates or sales attributable to the creator.
About this sample: Illustrative fictional metrics, not a live creator lookup. Optional sections use the documented core and portrait containers; absent sections or metrics remain unavailable.
Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.
View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "chuhaijiang-tiktok-creator-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_creator_detail",
"arguments": {
"country": "us",
"id": "7302162228386776110",
"include": "core,portrait"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "chuhaijiang-tiktok-creator-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":{\"core\":{\"items\":[{\"tioktok_creator_detail_core_ec_video_count\":10,\"tioktok_creator_detail_core_ecom_video_avg_play_count\":1000}]},\"portrait\":{\"items\":[{\"portrait_follower_count\":5000}]}}}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": {
"core": {
"items": [
{
"tioktok_creator_detail_core_ec_video_count": 10,
"tioktok_creator_detail_core_ecom_video_avg_play_count": 1000
}
]
},
"portrait": {
"items": [
{
"portrait_follower_count": 5000
}
]
}
}
}
},
"isError": false
}
}