TikTok / Social Commerce

TikTok Product Search MCP Tool

Search and analyze TikTok product data including sales, influencer sales data, pricing, and commission rates across 16 TikTok Shop sites.

MCP tool name

nexscope_tiktok_product_search

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-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_product_search",
    "arguments": {
      "pageSize": 10,
      "region": "US",
      "pageNumber": 1,
      "keyword": "phone case"
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/tiktok-product-search

Arguments

Name	Type	Required	Meaning
`keyword`	`string`	optional	Product keyword (please translate to the local language). Max length 1000 Example: phone case
`region`	`string`	optional	Region, default US. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France) Example: US
`categoryKeywordCN`	`string`	optional	Product category (please enter in Chinese). Max length 1000 Example: phone case
`minTotalSaleCnt`	`integer`	optional	Total sales (minimum) Example: 1
`maxTotalSaleCnt`	`integer`	optional	Total sales (maximum) Example: 1
`minTotalSale30dCnt`	`integer`	optional	30-day sales (minimum) Example: 1
`maxTotalSale30dCnt`	`integer`	optional	30-day sales (maximum) Example: 1
`minTotalSaleGmvAmt`	`string`	optional	Product total GMV (minimum). Max length 1000 Example: {}
`maxTotalSaleGmvAmt`	`string`	optional	Product total GMV (maximum). Max length 1000 Example: {}
`minTotalSaleGmv30dAmt`	`string`	optional	Product total GMV (30-day) (minimum). Max length 1000 Example: {}
`maxTotalSaleGmv30dAmt`	`string`	optional	Product total GMV (30-day) (maximum). Max length 1000 Example: {}
`minSpuAvgPrice`	`number`	optional	SPU average price (minimum) Example: 1
`maxSpuAvgPrice`	`number`	optional	SPU average price (maximum) Example: 1
`minProductRating`	`number`	optional	Product rating (minimum) Example: 1
`maxProductRating`	`number`	optional	Product rating (maximum) Example: 1
`minReviewCount`	`integer`	optional	Review count (minimum) Example: 1
`maxReviewCount`	`integer`	optional	Review count (maximum) Example: 1
`minProductCommissionRate`	`number`	optional	Product commission rate (minimum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05 Example: 1
`maxProductCommissionRate`	`number`	optional	Product commission rate (maximum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05 Example: 1
`minTotalIflCnt`	`integer`	optional	Promoting creator count (minimum) Example: 1
`maxTotalIflCnt`	`integer`	optional	Promoting creator count (maximum) Example: 1
`minTotalVideoCnt`	`integer`	optional	Promotional video count (minimum) Example: 1
`maxTotalVideoCnt`	`integer`	optional	Promotional video count (maximum) Example: 1
`minTotalViewsCnt`	`integer`	optional	Promotional view count (minimum) Example: 1
`maxTotalViewsCnt`	`integer`	optional	Promotional view count (maximum) Example: 1
`minFirstCrawlDt`	`integer`	optional	Product listing time (minimum), format YYYYMMDD (e.g., 20200101 represents 2020-01-01) Example: 1
`maxFirstCrawlDt`	`integer`	optional	Product listing time (maximum), format YYYYMMDD Example: 1
`saleDays`	`integer`	optional	Days the product has been on sale, unit is days Example: 1
`productSortField`	`integer`	optional	Sort field: 1=total sales, 2=total GMV, 3=SPU average price, 4=7-day sales, 5=30-day sales, 6=7-day GMV, 7=30-day GMV. Default 1 Example: 1
`sortType`	`integer`	optional	Sort direction: 0=ascending, 1=descending. Default 1 Example: 1
`pageNum`	`integer`	optional	Page number. Default 1 Example: 1
`pageSize`	`integer`	optional	Items per page. Default 50 Example: 10

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.total`	`integer`	optional	Record count Example: 1
`data.products`	`array`	optional	Product information list (see below) Example: []
`data.columns`	`array`	optional	Rendered columns Example: []
`data.type`	`string`	optional	Render style Example: null
`data.costToken`	`integer`	optional	Token cost Example: 1
`data.products[].productId`	`string`	optional	Product unique identifier ID Example: example-id
`data.products[].productName`	`string`	optional	Product name Example: null
`data.products[].title`	`string`	optional	Product name Example: null
`data.products[].imageUrl`	`string`	optional	Product image URL Example: https://example.com/image.jpg
`data.products[].coverUrl`	`string`	optional	Cover image URL list Example: https://example.com/image.jpg
`data.products[].productImageUrls`	`array`	optional	Product image URL list Example: []
`data.products[].categoryName`	`string`	optional	Product category name Example: null
`data.products[].categoryIds`	`array`	optional	Product category ID list Example: []
`data.products[].region`	`string`	optional	Region code Example: US
`data.products[].currency`	`string`	optional	Currency Example: null
`data.products[].price`	`number`	optional	Product price Example: 1
`data.products[].minPrice`	`number`	optional	Minimum price Example: 1
`data.products[].maxPrice`	`number`	optional	Maximum price Example: 1
`data.products[].spuAvgPrice`	`number`	optional	SPU average price Example: 1
`data.products[].productRating`	`number`	optional	Product rating Example: 1
`data.products[].reviewCount`	`integer`	optional	Review count Example: 1
`data.products[].ratings`	`integer`	optional	Review count Example: 1
`data.products[].productCommissionRate`	`number`	optional	Product commission rate Example: 1
`data.products[].totalSaleCnt`	`integer`	optional	Total sales Example: 1
`data.products[].totalSale1dCnt`	`integer`	optional	Total sales in 1 day Example: 1
`data.products[].totalSale7dCnt`	`integer`	optional	Total sales in 7 days Example: 1
`data.products[].totalSale15dCnt`	`integer`	optional	Total sales in 15 days Example: 1
`data.products[].totalSale30dCnt`	`integer`	optional	Total sales in 30 days Example: 1
`data.products[].totalSale60dCnt`	`integer`	optional	Total sales in 60 days Example: 1
`data.products[].totalSale90dCnt`	`integer`	optional	Total sales in 90 days Example: 1
`data.products[].monthlySalesUnits`	`integer`	optional	Monthly sales Example: 1
`data.products[].totalSaleGmvAmt`	`number`	optional	Total GMV Example: 1
`data.products[].totalSaleGmv1dAmt`	`number`	optional	Total GMV in 1 day Example: 1
`data.products[].totalSaleGmv7dAmt`	`number`	optional	Total GMV in 7 days Example: 1
`data.products[].totalSaleGmv15dAmt`	`number`	optional	Total GMV in 15 days Example: 1
`data.products[].totalSaleGmv30dAmt`	`number`	optional	Total GMV in 30 days Example: 1
`data.products[].totalSaleGmv60dAmt`	`number`	optional	Total GMV in 60 days Example: 1
`data.products[].totalSaleGmv90dAmt`	`number`	optional	Total GMV in 90 days Example: 1
`data.products[].firstCrawlDt`	`integer`	optional	Listing date Example: 1
`data.products[].availableDate`	`string`	optional	Listing time (timestamp) Example: 2026-01-01
`data.products[].discount`	`string`	optional	Discount info Example: null
`data.products[].freeShippingText`	`string`	optional	Whether free shipping Example: null
`data.products[].offMarkText`	`string`	optional	Whether there is a discount mark Example: null
`data.products[].salesFlagText`	`string`	optional	Selling method Example: null
`data.products[].salesTrendFlagText`	`string`	optional	Sales trend indicator Example: null
`data.products[].isSShopText`	`string`	optional	Whether S store Example: null
`data.products[].salePropsInfo`	`array`	optional	Sales property info (product specifications) Example: []
`data.products[].sourceTool`	`string`	optional	Source tool Example: null
`data.products[].sourceType`	`string`	optional	Product source Example: null
`data.products[].asin`	`string`	optional	Product ID Example: B072MQ5BRX
`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

{
  "pageSize": 10,
  "region": "US",
  "pageNumber": 1,
  "keyword": "phone case"
}

Example structuredContent

{
  "data": {
    "total": 1,
    "products": [
      {
        "productId": "example-id",
        "imageUrl": "https://example.com/image.jpg",
        "coverUrl": "https://example.com/image.jpg",
        "productImageUrls": [],
        "categoryIds": [],
        "region": "US",
        "price": 1,
        "minPrice": 1,
        "maxPrice": 1,
        "spuAvgPrice": 1,
        "productRating": 1,
        "reviewCount": 1,
        "ratings": 1,
        "productCommissionRate": 1,
        "totalSaleCnt": 1,
        "totalSale1dCnt": 1,
        "totalSale7dCnt": 1,
        "totalSale15dCnt": 1,
        "totalSale30dCnt": 1,
        "totalSale60dCnt": 1,
        "totalSale90dCnt": 1,
        "monthlySalesUnits": 1,
        "totalSaleGmvAmt": 1,
        "totalSaleGmv1dAmt": 1,
        "totalSaleGmv7dAmt": 1,
        "totalSaleGmv15dAmt": 1,
        "totalSaleGmv30dAmt": 1,
        "totalSaleGmv60dAmt": 1,
        "totalSaleGmv90dAmt": 1,
        "firstCrawlDt": 1,
        "availableDate": "2026-01-01",
        "salePropsInfo": [],
        "asin": "B072MQ5BRX"
      }
    ],
    "columns": [],
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}