tiktok_top_ads_list
Fetch high-performing TikTok auction ads from Creative Center by keyword, industry, country, period, format, or sort order to research ad creatives.
Instructions
Retrieve TikTok Top Ads. Returns high-performing auction ads from TikTok Creative Center. The service defaults period to 30, page to 1, limit to 20, and order_by to for_you. Use /tiktok/top-ads/filters for dynamic enum values and static enums for order, duration, likes, and ad format.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "tiktok_top_ads_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| like | No | Like percentile bucket id or comma-separated ids | |
| page | No | Page number | |
| limit | No | Maximum number of ads to return | |
| period | No | Lookback period in days | |
| keyword | No | Brand or product keyword search | |
| duration | No | Video duration bucket | |
| industry | No | Industry filter id or comma-separated ids from /tiktok/top-ads/filters | |
| order_by | No | Sort order | |
| ad_format | No | Ad format id | |
| objective | No | Objective filter id or comma-separated ids from /tiktok/top-ads/filters | |
| ad_language | No | Ad language id or comma-separated ids from /tiktok/top-ads/filters | |
| country_code | No | Country code or comma-separated country codes from /tiktok/top-ads/filters | |
| pattern_label | No | Pattern label id or comma-separated ids from /tiktok/top-ads/filters |