TikTok Commerce Intelligence CJ

TikTok Shop Search

Search TikTok shops to find competing sellers. Call the TikTok Shop Search API via REST or MCP from 38 credits per call.

MCP tool name

nexscope_chuhaijiang_tiktok_shop_search

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": "chuhaijiang-tiktok-shop-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_chuhaijiang_tiktok_shop_search",
    "arguments": {
      "country": "us",
      "keyword": "beauty",
      "minRating": 4,
      "pageSize": 3
    }
  }
}

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
`country`	`string`	required	Lowercase TikTok market code. Example: us
`page`	`integer`	optional	Page number, starting at 1. Example: 1
`pageSize`	`integer`	optional	Maximum records per page. Example: 3
`keyword`	`string`	optional	Shop search keyword. Example: beauty
`category`	`string`	optional	Product category ID. Example: {}
`sellerType`	`string`	optional	Provider-supported seller type. Example: {}
`sort`	`string`	optional	Provider sort field and direction (field:asc or field:desc). Example: gmv_7d:desc
`minRating`	`number`	optional	Minimum shop rating. Example: 4
`maxRating`	`number`	optional	Maximum shop rating. Example: {}
`minSold7d`	`number`	optional	Minimum 7-day sales. Example: {}
`maxSold7d`	`number`	optional	Maximum 7-day sales. Example: {}
`minGmv7d`	`number`	optional	Minimum 7-day GMV. Example: {}
`maxGmv7d`	`number`	optional	Maximum 7-day GMV. Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`errcode`	`integer`	optional	200 means success Example: {}
`errmsg`	`string`	optional	`ok` on success Example: {}
`request_id`	`string`	optional	Request tracking ID Example: {}
`data`	`object`	optional	Store list is at `data.items[]`, total number is `data.total_count` Example: {}
`id`	`string`	optional	Store ID, can be passed to details and association endpoints Example: {}
`shop_sold_count_for_last_7_days`	`number`	optional	Sales volume in the past 7 days Example: {}
`total_related_creator_count`	`number`	optional	Cumulative number of connected people Example: {}
`seller_business_info`	`array<string>`	optional	Business entity information Example: {}
`sold_count_trend`	`array<object>`	optional	Sales trend points, including `timestamp`, `value` Example: {}
`id`	`string`	optional	Store ID Example: {}
`shopname`	`string`	optional	Store name Example: {}
`region`	`string`	optional	shop market Example: {}
`shoprating`	`number`	optional	Store rating Example: {}
`shopmaincategory`	`string`	optional	Main business classification Example: {}
`shopproductcount`	`number`	optional	Number of items Example: {}
`shoptotalsoldcount`	`number`	optional	Cumulative sales Example: {}
`shoptotalgmv`	`object`	optional	Cumulative GMV Example: {}
`shopsoldcountforlast7days`	`number`	optional	Sales volume in the past 7 days Example: {}
`shopgmvforlast7days`	`object`	optional	GMV in the last 7 days Example: {}
`totalrelatedcreatorcount`	`number`	optional	Cumulative number of connected people Example: {}
`sellerbusinessinfo`	`array`	optional	Business entity information Example: {}
`soldcounttrend`	`array<object>`	optional	sales trends Example: {}
`shop_rating`	`number`	optional	Store rating Example: {}
`shop_total_gmv`	`object`	optional	Cumulative GMV Example: {}
`shop_main_category`	`string`	optional	Main business classification Example: {}
`business_info`	`array`	optional	Business entity Example: {}
`seller_avatar`	`object`	optional	Seller avatar Example: {}
`creator_role`	`integer`	optional	Account role Example: {}

Examples

Example arguments

{
  "country": "us",
  "keyword": "beauty",
  "minRating": 4,
  "pageSize": 3
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}