anyapi_tiktok_top_ads_search $0.0015 per call
TikTok Top Ads Search. Search TikTok Creative Center top video ads by keyword with explicit performance, objective, region, language, and time-window filters. (AnyAPI · TikTok)
For AI agents: call anyapi_tiktok_top_ads_search
POST https://toll402.dev/v1/p/anyapi.tiktok.top_ads_search
{
"query": "glasses"
}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": {
"adLanguage": {
"type": "string",
"description": "Language code for returned ads (default en).",
"default": "en",
"enum": [
"en",
"es",
"ar",
"vi",
"th",
"de",
"id",
"pt",
"fr",
"ms",
"nl",
"ja",
"it",
"ro",
"zh-Hant",
"ko"
]
},
"limit": {
"type": "integer",
"description": "Maximum number of ads requested for this page, from 1 through 20 (default 20).",
"default": 20
},
"objective": {
"type": "string",
"description": "Campaign objective filter (default traffic).",
"default": "traffic",
"enum": [
"traffic",
"app_installs",
"conversions",
"video_views",
"reach",
"lead_generation",
"product_sales"
]
},
"orderBy": {
"type": "string",
"description": "Result ordering: Creative Center recommendations or like count (default for_you).",
"default": "for_you",
"enum": [
"for_you",
"likes"
]
},
"page": {
"type": "integer",
"description": "One-based provider page number (default 1).",
"default": 1
},
"performanceRank": {
"type": "string",
"description": "Ad performance percentile bucket, where top_1_20 is the highest-performing 20 percent (default top_1_20).",
"default": "top_1_20",
"enum": [
"top_1_20",
"top_21_40",
"top_41_60",
"top_61_80"
]
},
"period": {
"type": "integer",
"description": "Lookback period in days (default 180).",
"default": 180,
"enum": [
7,
30,
180
]
},
"query": {
"type": "string",
"description": "Keyword to search in TikTok Creative Center top video ads.",
"examples": [
"glasses"
]
},
"region": {
"type": "string",
"description": "Country code used to select the Creative Center market (default US).",
"default": "US"
}
},
"additionalProperties": true,
"required": [
"query"
]
}
MCP
{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}