TikTok Intelligence ET

TikTok Batch Product Detail

Look up multiple TikTok Shop products with sales, prices, ratings, and commission data. Call via REST API or MCP from 10 credits per call.

MCP tool name

nexscope_tiktok_batch_product_detail

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "tiktok-batch-product-detail-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_batch_product_detail",
    "arguments": {
      "productIds": [
        "1732294342978343112"
      ]
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress 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
`productIds`	`array`	optional	List of product IDs (max 1000). Example: ["1729382310407603945", "1729382310407603946"] Example: [ "1732294342978343112" ]
`productUrls`	`array`	optional	List of product URLs (max 1000), in the form https://shop.tiktok.com/us/pdp/<slug>/<productId>?...; the backend will extract the trailing productId from each URL and merge into productIds, not mutually exclusive with productIds Example: []

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Number of records Example: {}
`products`	`array`	optional	List of product details (see product object below for details) Example: {}
`columns`	`array`	optional	Rendered columns Example: {}
`type`	`string`	optional	Rendering style Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`productId`	`string`	optional	Product ID Example: {}
`productName`	`string`	optional	Product name Example: {}
`imageUrl`	`string`	optional	Product pictures Example: {}
`productImageUrls`	`array`	optional	Product picture list Example: {}
`region`	`string`	optional	area code Example: {}
`sellerId`	`string`	optional	Seller ID Example: {}
`categoryId`	`string`	optional	First level classification ID Example: {}
`categoryL2Id`	`string`	optional	Secondary classification ID Example: {}
`categoryL3Id`	`string`	optional	Third level classification ID Example: {}
`minPrice`	`number`	optional	Minimum SKU price (USD) Example: {}
`maxPrice`	`number`	optional	Maximum SKU price (USD) Example: {}
`spuAvgPrice`	`number`	optional	SPU average price (USD) Example: {}
`productRating`	`number`	optional	product rating Example: {}
`reviewCount`	`integer`	optional	Number of comments Example: {}
`productCommissionRate`	`number`	optional	Product commission ratio Example: {}
`totalSaleCnt`	`integer`	optional	total sales Example: {}
`totalSale1dCnt`	`integer`	optional	Sales volume in the past day Example: {}
`totalSale7dCnt`	`integer`	optional	Sales volume in the past 7 days Example: {}
`totalSale15dCnt`	`integer`	optional	Sales volume in the past 15 days Example: {}
`totalSale30dCnt`	`integer`	optional	Sales volume in the past 30 days Example: {}
`totalSale60dCnt`	`integer`	optional	Sales volume in the past 60 days Example: {}
`totalSale90dCnt`	`integer`	optional	Sales volume in the past 90 days Example: {}
`totalSaleGmvAmt`	`number`	optional	total sales Example: {}
`totalSaleGmv1dAmt`	`number`	optional	Sales in the past day Example: {}
`totalSaleGmv7dAmt`	`number`	optional	Sales in the past 7 days Example: {}
`totalSaleGmv15dAmt`	`number`	optional	Sales in the past 15 days Example: {}
`totalSaleGmv30dAmt`	`number`	optional	Sales in the past 30 days Example: {}
`totalSaleGmv60dAmt`	`number`	optional	Sales in the past 60 days Example: {}
`totalSaleGmv90dAmt`	`number`	optional	Sales in the past 90 days Example: {}
`totalLiveCnt`	`integer`	optional	Total number of live broadcasts Example: {}
`totalLive1dCnt`	`integer`	optional	Number of live broadcasts in the past day Example: {}
`totalLive7dCnt`	`integer`	optional	Number of live broadcasts in the past 7 days Example: {}
`totalLive15dCnt`	`integer`	optional	Number of live broadcasts in the past 15 days Example: {}
`totalLive30dCnt`	`integer`	optional	Number of live broadcasts in the past 30 days Example: {}
`totalLive60dCnt`	`integer`	optional	Number of live broadcasts in the past 60 days Example: {}
`totalLive90dCnt`	`integer`	optional	Number of live broadcasts in the past 90 days Example: {}
`totalLiveSale1dCnt`	`integer`	optional	Live streaming sales in the past day Example: {}
`totalLiveSale7dCnt`	`integer`	optional	Live streaming sales in the past 7 days Example: {}
`totalLiveSale15dCnt`	`integer`	optional	Live streaming sales in the past 15 days Example: {}
`totalLiveSale30dCnt`	`integer`	optional	Live streaming sales in the past 30 days Example: {}
`totalLiveSale60dCnt`	`integer`	optional	Live broadcast sales in the past 60 days Example: {}
`totalLiveSale90dCnt`	`integer`	optional	Live broadcast sales in the past 90 days Example: {}
`totalLiveSaleGmv1dAmt`	`integer`	optional	Live broadcast sales in the past day Example: {}
`totalLiveSaleGmv7dAmt`	`integer`	optional	Live broadcast sales in the past 7 days Example: {}
`totalLiveSaleGmv15dAmt`	`integer`	optional	Live broadcast sales in the past 15 days Example: {}
`totalLiveSaleGmv30dAmt`	`integer`	optional	Live streaming sales in the past 30 days Example: {}
`totalLiveSaleGmv60dAmt`	`integer`	optional	Live streaming sales in the past 60 days Example: {}
`totalLiveSaleGmv90dAmt`	`integer`	optional	Live broadcast sales in the past 90 days Example: {}
`totalVideoCnt`	`integer`	optional	Total number of videos Example: {}
`totalVideo1dCnt`	`integer`	optional	Number of videos in the past day Example: {}
`totalVideo7dCnt`	`integer`	optional	Number of videos in the past 7 days Example: {}
`totalVideo15dCnt`	`integer`	optional	Number of videos in the past 15 days Example: {}
`totalVideo30dCnt`	`integer`	optional	Number of videos in the past 30 days Example: {}
`totalVideo60dCnt`	`integer`	optional	Number of videos in the past 60 days Example: {}
`totalVideo90dCnt`	`integer`	optional	Number of videos in the past 90 days Example: {}
`totalIflCnt`	`integer`	optional	Total number of experts Example: {}
`totalIflVideo1dCnt`	`integer`	optional	The number of videos of experts in the past day Example: {}
`totalIflVideo7dCnt`	`integer`	optional	The number of videos of experts in the past 7 days Example: {}
`totalIflVideo15dCnt`	`integer`	optional	The number of videos of experts in the past 15 days Example: {}
`totalIflVideo30dCnt`	`integer`	optional	The number of videos of experts in the past 30 days Example: {}
`totalIflVideo60dCnt`	`integer`	optional	The number of videos of experts in the past 60 days Example: {}
`totalIflVideo90dCnt`	`integer`	optional	Number of expert videos in the past 90 days Example: {}
`totalIflLive1dCnt`	`integer`	optional	Number of live broadcasts by experts in the past day Example: {}
`totalIflLive7dCnt`	`integer`	optional	Number of live broadcasts by experts in the past 7 days Example: {}
`totalIflLive15dCnt`	`integer`	optional	Number of live broadcasts by experts in the past 15 days Example: {}
`totalIflLive30dCnt`	`integer`	optional	Number of live broadcasts by experts in the past 30 days Example: {}
`totalIflLive60dCnt`	`integer`	optional	Number of live broadcasts by experts in the past 60 days Example: {}
`totalIflLive90dCnt`	`integer`	optional	Number of live broadcasts by experts in the past 90 days Example: {}
`totalViewsCnt`	`integer`	optional	total views Example: {}
`totalViews1dCnt`	`integer`	optional	Number of views in the past day Example: {}
`totalViews7dCnt`	`integer`	optional	Number of views in the last 7 days Example: {}
`totalViews15dCnt`	`integer`	optional	Number of views in the past 15 days Example: {}
`totalViews30dCnt`	`integer`	optional	Number of views in the past 30 days Example: {}
`totalViews60dCnt`	`integer`	optional	Number of views in the past 60 days Example: {}
`totalViews90dCnt`	`integer`	optional	Number of views in the past 90 days Example: {}
`discount`	`string`	optional	discount information Example: {}
`freeShipping`	`integer`	optional	Is shipping free? Example: {}
`salesFlag`	`integer`	optional	Main delivery methods Example: {}
`salesTrendFlag`	`integer`	optional	Sales trend identification: 0=stable, 1=increasing, 2=declining Example: {}
`isSShop`	`integer`	optional	Whether the store is fully managed Example: {}
`offMark`	`integer`	optional	Product removal mark Example: {}
`firstCrawlDt`	`string`	optional	First crawl date Example: {}
`descDetail`	`string`	optional	Product details description Example: {}

Examples

Example arguments

{
  "productIds": [
    "1732294342978343112"
  ]
}

Example structuredContent

{}