tikhub_x_tiktok-ads-search-ads $0.00125 per call

Search TikTok ads. Tiktok: Search ads (TikHub · TikTok Ads)

For AI agents: call tikhub_x_tiktok-ads-search-ads
POST https://toll402.dev/v1/p/tikhub.x.tiktok-ads-search-ads
{
 "limit": 5
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "objective": {
   "type": "integer",
   "description": "广告目标类型/Ad objective (1:流量 2:应用安装 3:转化 4:视频浏览 5:触达 6:潜在客户 7:产品销售)",
   "examples": [
    1
   ]
  },
  "like": {
   "type": "integer",
   "description": "表现排名/Performance rank (1:前1-20% 2:前21-40% 3:前41-60% 4:前61-80%)",
   "examples": [
    1
   ]
  },
  "period": {
   "type": "integer",
   "description": "Time period in days. Allowed values 7 | 30 | 120 | 180 (TikHub OpenAPI: e.g. 7, 30, 120, 180 days). Other integers fail Creative Center nested validation.",
   "examples": [
    180
   ]
  },
  "industry": {
   "type": "string",
   "description": "Industry ID"
  },
  "keyword": {
   "type": "string",
   "description": "Search keyword"
  },
  "page": {
   "type": "integer",
   "description": "Page number",
   "examples": [
    1
   ]
  },
  "limit": {
   "type": "integer",
   "description": "Items per page. Default 20. Prefer limit ≤ 20 — live Creative Center validation has rejected values above 20 (30/50) even though some OpenAPI text says max 50.",
   "examples": [
    20
   ]
  },
  "order_by": {
   "type": "string",
   "description": "Sort by (for_you, likes)",
   "examples": [
    "for_you"
   ]
  },
  "country_code": {
   "type": "string",
   "description": "Country code. May not always filter results the way agents expect (some codes, e.g. PH, have been observed appearing ignored).",
   "examples": [
    "US"
   ]
  },
  "ad_format": {
   "type": "integer",
   "description": "广告格式/Ad format (1:视频)",
   "examples": [
    1
   ]
  },
  "ad_language": {
   "type": "string",
   "description": "Ad language",
   "examples": [
    "en"
   ]
  },
  "search_id": {
   "type": "string",
   "description": "Search ID (optional)"
  }
 },
 "additionalProperties": true
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI