TikTok Commerce Intelligence CJ

TikTok Ad Search

Search TikTok ads for competitor and creative research. Call the TikTok Ad Search API via REST or MCP from 38 credits per call.

MCP tool name

nexscope_chuhaijiang_tiktok_ad_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-ad-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_chuhaijiang_tiktok_ad_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	Ad search keyword. Example: beauty
`category`	`string`	optional	Provider-approved product category. Example:
`adType`	`string`	optional	Provider-approved ad type value; no enum is published. Example:
`excludeSparkAds`	`boolean`	optional	Whether to exclude Spark Ads. Example: true
`minViews`	`number`	optional	Provider filter value; retain the provider metric definition without unit conversion. Example: 0
`maxViews`	`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
`minDays`	`number`	optional	Provider filter value; retain the provider metric definition without unit conversion. Example: 0
`maxDays`	`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	Business data, list at `data.items[]`, total number `data.total_count` Example: {}
`total_sc`	`number`	optional	Total SC Metrics 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"
}