Nexscope
Start free

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
Legacy MCP endpoint
/api/skill-api/v1/mcp
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"
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/tiktok-seller-detail

Arguments

NameTypeRequiredMeaning
sellerIdstringrequired
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.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.costTokenintegeroptional
Token cost
Example: 1
data.columnsarrayoptional
Render column definitions (display metadata)
Example: []
data.typestringoptional
Render style (e.g., tableListWorkbenches)
Example: null
data.columns[].sellerIdstringoptional
Store ID
Example: example-id
data.columns[].sellerNamestringoptional
Store name
Example: null
data.columns[].sellerLinkstringoptional
Store link
Example: null
data.columns[].coverUrlstringoptional
Store cover image URL
Example: https://example.com/image.jpg
data.columns[].regionstringoptional
Region
Example: US
data.columns[].categoryIdstringoptional
Primary category ID
Example: example-id
data.columns[].categoryL2Idstringoptional
Secondary category ID
Example: example-id
data.columns[].categoryL3Idstringoptional
Tertiary category ID
Example: example-id
data.columns[].totalSaleCntintegeroptional
Total sales
Example: 1
data.columns[].totalSale1dCntintegeroptional
Sales in last 1 day (increment)
Example: 1
data.columns[].totalSale7dCntintegeroptional
Sales in last 7 days (increment)
Example: 1
data.columns[].totalSale30dCntintegeroptional
Sales in last 30 days (increment)
Example: 1
data.columns[].totalSale90dCntintegeroptional
Sales in last 90 days (increment)
Example: 1
data.columns[].totalSaleGmvAmtnumberoptional
Total GMV
Example: 1
data.columns[].totalSaleGmv1dAmtnumberoptional
GMV in last 1 day (increment)
Example: 1
data.columns[].totalSaleGmv7dAmtnumberoptional
GMV in last 7 days (increment)
Example: 1
data.columns[].totalSaleGmv30dAmtnumberoptional
GMV in last 30 days (increment)
Example: 1
data.columns[].totalSaleGmv90dAmtnumberoptional
GMV in last 90 days (increment)
Example: 1
data.columns[].followersCountintegeroptional
Follower count
Example: 1
data.columns[].ratingnumberoptional
Rating
Example: 1
data.columns[].reviewCountintegeroptional
Review count
Example: 1
data.columns[].positiveFeedbackRatenumberoptional
Positive feedback rate
Example: 1
data.columns[].responseRatenumberoptional
Response rate
Example: 1
data.columns[].deliveryRateintegeroptional
Delivery rate
Example: 1
data.columns[].totalProductCntintegeroptional
Historical product count in store (including delisted)
Example: 1
data.columns[].totalCrawlProductCntintegeroptional
Current product count in store
Example: 1
data.columns[].spuAvgPricenumberoptional
Average SKU price across the store
Example: 1
data.columns[].minPriceintegeroptional
Minimum price
Example: 1
data.columns[].maxPriceintegeroptional
Maximum price
Example: 1
data.columns[].totalIflCntintegeroptional
Total promoting creator count
Example: 1
data.columns[].totalVideoCntintegeroptional
Total promotional video count
Example: 1
data.columns[].totalLiveCntintegeroptional
Total livestream count
Example: 1
data.columns[].salesFlagTextstringoptional
Primary selling method (video sales / livestream sales)
Example: null
data.columns[].salesTrendFlagTextstringoptional
Sales trend (rising / falling / stable)
Example: null
data.columns[].shopIdentityLabelstringoptional
Store identity (e.g., OFFICIAL SHOP)
Example: null
data.columns[].shopTypeTextstringoptional
Whether a brand store (Yes / No)
Example: null
data.columns[].fromFlagTextstringoptional
Cross-border identifier (local / cross-border)
Example: null
data.columns[].productCategoryListstringoptional
Product categories (JSON string, containing category_name / category_id)
Example: null
data.columns[].mostProductCategoryListstringoptional
TOP1 product category (JSON string)
Example: null
data.columns[].firstCrawlDtintegeroptional
Estimated listing time, in yyyyMMdd format (e.g., 20240504 represents 2024-05-04)
Example: 1
data.columns[].userIdstringoptional
Creator UID
Example: example-id
data.columns[].sourceTypestringoptional
Product source (e.g., Tiktok)
Example: null
data.columns[].sourceToolstringoptional
Source tool (e.g., EchoTik-Seller Detail)
Example: null
data.titlestringoptional
Provider-specific response title.
Example: null
data.sourceTypestringoptional
Provider-specific source platform type.
Example: null
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null
data.costTimeintegeroptional
Execution time reported by the upstream provider.
Example: null
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
datanullrequired
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
}