TOOL API

tool_search_keyword_recommend

Returns recommended search keywords and predicted monthly searches for Search Ads Campaigns. Recommendations can be generated from exactly one source: `search_queries`, `ad_ids`, or `landing_page_urls`. Using `ad_ids` or `landing_page_urls` is currently allowlist-only; contact your TikTok representative for access.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.tool_search_keyword_recommend
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

ad_ids

Required when you want recommended search keywords based on specific ads. You can specify only one of `search_queries`, `ad_ids`, or `landing_page_urls`. Maximum 1 ad ID. This is currently an allowlist-only feature; contact your TikTok representative for access.

advertiser_idrequired

Advertiser ID.

landing_page_urls

Required when you want recommended search keywords based on URLs. You can specify only one of `search_queries`, `ad_ids`, or `landing_page_urls`. Maximum 5 landing page URLs. There is no length limit for each URL. This is currently an allowlist-only feature; contact your TikTok representative for access.

order_field

Sorting logic. `RELEVANCE` sorts by relevance. `MONTHLY_SEARCHES` sorts by the `monthly_searches` result field. Default when `search_queries` is specified: `RELEVANCE`. When `ad_ids` or `landing_page_urls` is specified, this field can only be `MONTHLY_SEARCHES`.

order_type

Sorting order. Valid only when `order_field` is `MONTHLY_SEARCHES`. `ASC` means ascending and `DESC` means descending. Default value: `DESC`. When `ad_ids` or `landing_page_urls` is specified, this field can only be `DESC`.

page

Current page number. Value range: greater than or equal to 1. Default value: 1.

page_size

Page size. Value range: 1-1,000. Default value: 50.

regionsrequired

List of country or region codes. Currently, the only supported value is `US`.

search_queries

Required when you want recommended search keywords based on search queries. You can specify only one of `search_queries`, `ad_ids`, or `landing_page_urls`. Provide products, services, or brands as queries. Maximum 5 items; each query can be up to 80 characters. Only English words are supported; emojis and special symbols such as `#` are not supported.

total_size

Total number of recommended keywords to return. Value range: 1-1,000. Default value: 1,000.