TikTok Commerce Intelligence CJ

TikTok Live Search

Search TikTok livestreams for product and content research. Call the TikTok Live Search API via REST or MCP from 38 credits per call.

MCP tool name

nexscope_chuhaijiang_tiktok_live_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-live-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_chuhaijiang_tiktok_live_search",
    "arguments": {
      "country": "us",
      "page": 1,
      "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 request market. Returned country_code may differ; preserve both. Example: us
`page`	`integer`	optional	Page number, starting at 1. No automatic pagination. Example: 1
`pageSize`	`integer`	optional	Items per page, from 1 to 10. Omission preserves the upstream default. Example: 3
`keyword`	`string`	optional	Livestream keyword. Example: beauty
`category`	`string`	optional	Provider-approved livestream category; no enum is published. Example:
`productCategory`	`string`	optional	Provider-approved product category. Example:
`isLiving`	`boolean`	optional	Filter currently live rooms. Example: true
`isCommercial`	`boolean`	optional	Filter rooms promoting products. Example: true
`minSold`	`number`	optional	Provider filter value; retain the provider metric definition without unit conversion. Example: 0
`maxSold`	`number`	optional	Provider filter value; retain the provider metric definition without unit conversion. Example: 0
`minGmv`	`number`	optional	Provider filter value; retain the provider metric definition without unit conversion. Example: 0
`maxGmv`	`number`	optional	Provider filter value; retain the provider metric definition without unit conversion. Example: 0
`minAudience`	`number`	optional	Provider filter value; retain the provider metric definition without unit conversion. Example: 0
`maxAudience`	`number`	optional	Provider filter value; retain the provider metric definition without unit conversion. Example: 0
`sort`	`string`	optional	Provider-approved field followed by :asc or :desc. No complete field enum is published. Example: gmv:desc

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	The live broadcast list is at `data.items[]`, the total number is `data.total_count` Example: {}
`id`	`string`	optional	Live room ID; details and associated products use this value Example: {}
`cover`	`object`	optional	Cover object, including `url`, `thumb_url` Example: {}
`opm`	`number`	optional	Orders per thousand viewers Example: {}
`most_product_category_label`	`string`	optional	Main product categories Example: {}
`data.total_count`	`integer`	optional	Total number of matches Example: {}
`data.items[].id`	`string`	optional	Live broadcast room ID Example: {}
`user_category_label`	`string`	optional	Anchor classification tags Example: {}
`country_code`	`string`	optional	Record country code Example: {}
`cover`	`object`	optional	cover object Example: {}
`new_follow_count`	`number`	optional	Number of new fans Example: {}
`opm`	`number`	optional	Orders per thousand viewers Example: {}
`most_product_category_label`	`string`	optional	Main product categories Example: {}
`tiktok_live_detail_product_title`	`string`	optional	Product title Example: {}
`tiktok_live_detail_product_images`	`object`	optional	Product pictures Example: {}
`tiktok_live_detail_product_country_code`	`string`	optional	Product country code Example: {}
`tiktok_live_detail_product_sold_count`	`number`	optional	Related sales Example: {}
`tiktok_live_detail_product_gmv`	`object`	optional	Associated GMV Example: {}
`tiktok_live_detail_product_commission_rate_num`	`number`	optional	commission rate Example: {}
`tiktok_live_detail_product_conversion_rate`	`number`	optional	conversion rate Example: {}
`tiktok_live_detail_product_seller_avatar`	`object`	optional	Seller avatar Example: {}
`tiktok_live_detail_product_seller_info`	`array`	optional	Seller description text Example: {}
`tiktok_live_detail_product_seller_category_name_label`	`string`	optional	Seller classification tags Example: {}

Examples

Example arguments

{
  "country": "us",
  "page": 1,
  "pageSize": 3
}

Example structuredContent

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