Search TikTok Ad Library ads
tiktok_adLibrary_ads_search_getSearch TikTok Ads Library ads by keyword or advertiser name, filter results by country and date range, and page through returned ads using a cursor.
Instructions
Search the public TikTok Ads Library by keyword or advertiser name. Optional inputs: query, advertiserName, advertiserBusinessId, country, startDate and 2 more. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "tiktok_adLibrary_ads_search_get"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Keyword to search the public TikTok Ads Library. | |
| cursor | No | Opaque pagination cursor from a previous response. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| country | No | Country the ad was shown in (its targeting or delivery country, not the advertiser's). Case-insensitive. Omit it, or use `ALL`, for every supported country. The US isn't supported. | |
| endDate | No | Only ads last shown on or before this date (UTC, YYYY-MM-DD, inclusive). Use with `startDate`. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| startDate | No | Only ads last shown on or after this date (UTC, YYYY-MM-DD). Use with `endDate`. Without both, the search covers the last 30 days. A narrower window means fewer pages to read. | |
| advertiserName | No | Search the public TikTok Ads Library by advertiser name. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. | |
| advertiserBusinessId | No | TikTok advertiser business ID, from `advertiserMatches[].businessId` or an ad's `advertiserBusinessId`. Pins an advertiser search to that exact advertiser. Requires `advertiserName`. |