工具 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 积分

调用信息

工具标识
tiktok-ads.tool_search_keyword_recommend
服务提供方
TikTok 广告
平均响应
0 ms
近 7 天调用
0

输入参数

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_id必填

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.

regions必填

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.