TikTok / Social Commerce

TikTok Seller Detail MCP Tool

Query TikTok Shop store (seller) details, retrieving a complete store profile by sellerId with total sales, multi-period (1d/7d/30d/90d) sales and GMV, followers, rating, review count, positive feedback rate, delivery rate, response rate, in-store product count, promoting creator count, promotional video count, livestream count, price range, product categories, and estimated listing time.

MCP tool name

nexscope_tiktok_seller_detail

Equivalent REST API path

https://api.nexscope.ai/api/skill-api/v1/skills/tiktok-seller-detail/run

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If 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

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "tiktok-seller-detail-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_seller_detail",
    "arguments": {
      "sellerId": "7496162162184128712"
    }
  }
}

REST API equivalent

POST https://api.nexscope.ai/api/skill-api/v1/skills/tiktok-seller-detail/run

Canonical detail URL

https://www.nexscope.ai/mcp-map/tiktok-seller-detail

Arguments

Name	Type	Required	Meaning
`sellerId`	`string`	required	TikTok Shop seller ID. Obtainable from the "EchoTik TikTok Seller Search" skill (nexscope-echotik-list-seller) results, or from the ID in a known store link. Max length 1000 Example: 7496162162184128712

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.costToken`	`integer`	optional	Token cost Example: 1
`data.columns`	`array`	optional	Render column definitions (display metadata) Example: []
`data.type`	`string`	optional	Render style (e.g., tableListWorkbenches) Example: null
`data.columns[].sellerId`	`string`	optional	Store ID Example: example-id
`data.columns[].sellerName`	`string`	optional	Store name Example: null
`data.columns[].sellerLink`	`string`	optional	Store link Example: null
`data.columns[].coverUrl`	`string`	optional	Store cover image URL Example: https://example.com/image.jpg
`data.columns[].region`	`string`	optional	Region Example: US
`data.columns[].categoryId`	`string`	optional	Primary category ID Example: example-id
`data.columns[].categoryL2Id`	`string`	optional	Secondary category ID Example: example-id
`data.columns[].categoryL3Id`	`string`	optional	Tertiary category ID Example: example-id
`data.columns[].totalSaleCnt`	`integer`	optional	Total sales Example: 1
`data.columns[].totalSale1dCnt`	`integer`	optional	Sales in last 1 day (increment) Example: 1
`data.columns[].totalSale7dCnt`	`integer`	optional	Sales in last 7 days (increment) Example: 1
`data.columns[].totalSale30dCnt`	`integer`	optional	Sales in last 30 days (increment) Example: 1
`data.columns[].totalSale90dCnt`	`integer`	optional	Sales in last 90 days (increment) Example: 1
`data.columns[].totalSaleGmvAmt`	`number`	optional	Total GMV Example: 1
`data.columns[].totalSaleGmv1dAmt`	`number`	optional	GMV in last 1 day (increment) Example: 1
`data.columns[].totalSaleGmv7dAmt`	`number`	optional	GMV in last 7 days (increment) Example: 1
`data.columns[].totalSaleGmv30dAmt`	`number`	optional	GMV in last 30 days (increment) Example: 1
`data.columns[].totalSaleGmv90dAmt`	`number`	optional	GMV in last 90 days (increment) Example: 1
`data.columns[].followersCount`	`integer`	optional	Follower count Example: 1
`data.columns[].rating`	`number`	optional	Rating Example: 1
`data.columns[].reviewCount`	`integer`	optional	Review count Example: 1
`data.columns[].positiveFeedbackRate`	`number`	optional	Positive feedback rate Example: 1
`data.columns[].responseRate`	`number`	optional	Response rate Example: 1
`data.columns[].deliveryRate`	`integer`	optional	Delivery rate Example: 1
`data.columns[].totalProductCnt`	`integer`	optional	Historical product count in store (including delisted) Example: 1
`data.columns[].totalCrawlProductCnt`	`integer`	optional	Current product count in store Example: 1
`data.columns[].spuAvgPrice`	`number`	optional	Average SKU price across the store Example: 1
`data.columns[].minPrice`	`integer`	optional	Minimum price Example: 1
`data.columns[].maxPrice`	`integer`	optional	Maximum price Example: 1
`data.columns[].totalIflCnt`	`integer`	optional	Total promoting creator count Example: 1
`data.columns[].totalVideoCnt`	`integer`	optional	Total promotional video count Example: 1
`data.columns[].totalLiveCnt`	`integer`	optional	Total livestream count Example: 1
`data.columns[].salesFlagText`	`string`	optional	Primary selling method (video sales / livestream sales) Example: null
`data.columns[].salesTrendFlagText`	`string`	optional	Sales trend (rising / falling / stable) Example: null
`data.columns[].shopIdentityLabel`	`string`	optional	Store identity (e.g., OFFICIAL SHOP) Example: null
`data.columns[].shopTypeText`	`string`	optional	Whether a brand store (Yes / No) Example: null
`data.columns[].fromFlagText`	`string`	optional	Cross-border identifier (local / cross-border) Example: null
`data.columns[].productCategoryList`	`string`	optional	Product categories (JSON string, containing category_name / category_id) Example: null
`data.columns[].mostProductCategoryList`	`string`	optional	TOP1 product category (JSON string) Example: null
`data.columns[].firstCrawlDt`	`integer`	optional	Estimated listing time, in yyyyMMdd format (e.g., 20240504 represents 2024-05-04) Example: 1
`data.columns[].userId`	`string`	optional	Creator UID Example: example-id
`data.columns[].sourceType`	`string`	optional	Product source (e.g., Tiktok) Example: null
`data.columns[].sourceTool`	`string`	optional	Source tool (e.g., EchoTik-Seller Detail) Example: null
`data.title`	`string`	optional	Provider-specific response title. Example: null
`data.sourceType`	`string`	optional	Provider-specific source platform type. Example: null
`data.sourceTool`	`string`	optional	Provider-specific source tool name. Example: null
`data.costTime`	`integer`	optional	Execution time reported by the upstream provider. Example: null
`data.page`	`integer`	optional	Current page returned by the upstream provider. Example: null
`data.pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: null
`data.pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: null
`data.totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: null
`data.dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: null

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

{
  "sellerId": "7496162162184128712"
}

Example structuredContent

{
  "data": {
    "costToken": 1,
    "columns": [
      {
        "sellerId": "example-id",
        "coverUrl": "https://example.com/image.jpg",
        "region": "US",
        "categoryId": "example-id",
        "categoryL2Id": "example-id",
        "categoryL3Id": "example-id",
        "totalSaleCnt": 1,
        "totalSale1dCnt": 1,
        "totalSale7dCnt": 1,
        "totalSale30dCnt": 1,
        "totalSale90dCnt": 1,
        "totalSaleGmvAmt": 1,
        "totalSaleGmv1dAmt": 1,
        "totalSaleGmv7dAmt": 1,
        "totalSaleGmv30dAmt": 1,
        "totalSaleGmv90dAmt": 1,
        "followersCount": 1,
        "rating": 1,
        "reviewCount": 1,
        "positiveFeedbackRate": 1,
        "responseRate": 1,
        "deliveryRate": 1,
        "totalProductCnt": 1,
        "totalCrawlProductCnt": 1,
        "spuAvgPrice": 1,
        "minPrice": 1,
        "maxPrice": 1,
        "totalIflCnt": 1,
        "totalVideoCnt": 1,
        "totalLiveCnt": 1,
        "firstCrawlDt": 1,
        "userId": "example-id"
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}