anyapi_tiktok_ad_library_search $0.0015 per call

TikTok Ad Library Search. Search TikTok's ad library by keyword (top ads with brand, title, spend, CTR, likes, and video info). (AnyAPI · TikTok)

For AI agents: call anyapi_tiktok_ad_library_search
POST https://toll402.dev/v1/p/anyapi.tiktok.ad_library_search
{
 "limit": 20,
 "objective": "conversions",
 "period": 30,
 "query": "spotify"
}
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": {
  "adFormat": {
   "type": "string",
   "description": "Ad format filter.",
   "enum": [
    "spark_ads",
    "non_spark_ads"
   ]
  },
  "adLanguage": {
   "type": "string",
   "description": "Ad language filter.",
   "enum": [
    "en",
    "es",
    "ar",
    "vi",
    "th",
    "de",
    "id",
    "pt",
    "fr",
    "ms",
    "nl",
    "ja",
    "it",
    "ro",
    "zh-Hant",
    "ko"
   ]
  },
  "advertiserName": {
   "type": "string",
   "description": "Filter to a specific advertiser by name (searches the public TikTok Ads Library by advertiser)."
  },
  "cursor": {
   "type": "string",
   "description": "Page number for pagination (defaults to 1)."
  },
  "duration": {
   "type": "string",
   "description": "Video duration bucket filter.",
   "enum": [
    "under_10s",
    "10_20s",
    "20_30s",
    "30_40s",
    "40_50s",
    "over_50s"
   ]
  },
  "industry": {
   "type": "string",
   "description": "Advertiser industry filter.",
   "enum": [
    "apparel_accessories",
    "appliances",
    "apps",
    "baby_kids_maternity",
    "beauty_personal_care",
    "business_services",
    "ecommerce_non_app",
    "education",
    "financial_services",
    "food_beverage",
    "games",
    "health",
    "home_improvement",
    "household_products",
    "life_services",
    "news_entertainment",
    "pets",
    "sports_outdoor",
    "tech_electronics",
    "travel",
    "vehicle_transportation"
   ]
  },
  "likes": {
   "type": "string",
   "description": "Likes percentile bucket filter (top_1_20 is the top-performing 20 percent).",
   "enum": [
    "top_1_20",
    "top_21_40",
    "top_41_60",
    "top_61_80",
    "top_81_100"
   ]
  },
  "limit": {
   "type": "integer",
   "description": "Results per page, with an existing maximum of 50 (default 20). Use a canonical JSON integer; legacy numeric strings remain accepted.",
   "default": 20,
   "examples": [
    20
   ]
  },
  "objective": {
   "type": "string",
   "description": "Campaign objective filter.",
   "enum": [
    "app_installs",
    "conversions",
    "lead_generation",
    "product_sales",
    "reach",
    "traffic",
    "video_views"
   ],
   "examples": [
    "conversions"
   ]
  },
  "orderBy": {
   "type": "string",
   "description": "Sort metric: for_you, impression, play_2s_rate, play_6s_rate, cvr, ctr, or like."
  },
  "period": {
   "type": "integer",
   "description": "Time window for top ads. Use the canonical JSON integer 7, 30, or 180; legacy numeric strings remain accepted.",
   "enum": [
    7,
    30,
    180,
    "7",
    "30",
    "180"
   ],
   "examples": [
    30
   ]
  },
  "query": {
   "type": "string",
   "description": "Keyword to search ad titles and content (e.g. spotify).",
   "examples": [
    "spotify"
   ]
  },
  "region": {
   "type": "string",
   "description": "Country code (defaults to US)."
  }
 },
 "additionalProperties": true,
 "required": [
  "query"
 ]
}

MCP

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

All tools · OpenAPI