TikTok / Social Commerce

Tiktok Seller Detail

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. Trigger when users mention TikTok store detail, TikTok seller detail, TikTok store analysis, TikTok store data, TikTok store profile, TikTok Shop store detail, TikTok seller detail, Nexscope store profile. Even if the user does not explicitly mention "Nexscope" or "TikTok", trigger this skill whenever their need involves querying the full detail/profile of a specific TikTok Shop store (with a known sellerId).

post/api/skill-api/v1/skills/tiktok-seller-detail/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/tiktok-seller-detail/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

sellerIdstring required

TikTok Shop seller ID. Obtainable from the "Nexscope TikTok Seller Search" skill (nexscope-echotik-list-seller) results, or from the ID in a known store link. Max length 1000

Example request

{
  "sellerId": "7496162162184128712"
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "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"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.