工具 API

tool_search_keyword_idea_get

Discover new keywords and keyword ideas to help reach people interested in your business. This endpoint returns suggested keywords relevant to the provided keywords for a target country or region. Discovering new keywords for supported non-US locations outside of your home country is currently an allowlist-only feature; contact your TikTok representative for access.

ecommerceOAuth1 积分

调用信息

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

输入参数

advertiser_id必填

Advertiser ID.

brand_type

Brand filter. `BRAND` returns brand keywords, `NON_BRAND` returns non-brand keywords, and `ALL` returns all keywords. Defaults to `ALL`. This filter is only available when `country_codes` is set to `["US"]`. For all other countries or regions, `ALL` is the default and the only allowed value.

country_codes

Target country or region code for keyword discovery. Maximum size: 1. Defaults to `US`. Supported values are `AU`, `BR`, `CA`, `FR`, `DE`, `IT`, `MX`, `SA`, `ES`, `AE`, `GB`, and `US`. Discovering new keywords for supported non-US locations outside of your home country is currently an allowlist-only feature; contact your TikTok representative for access.

keywords必填

List of keywords describing products or services closely related to your business. Maximum 10 keywords per request. Each keyword can be up to 80 characters. Only English words are supported; emojis and special symbols such as `#` are not supported. For optimal results, provide all keywords in lowercase; uppercase keywords are not recommended.

order_field

Sort field for returned keyword ideas. `AVG_MONTHLY_SEARCHES` sorts by the average monthly search range indicated by `avg_monthly_searches_lower` and `avg_monthly_searches_upper`; `THREE_MONTH_CHANGE` sorts by `three_month_change`; `YEAR_OVER_YEAR_CHANGE` sorts by `year_over_year_change`; `COMPETITION` sorts by `competition`. Defaults to `AVG_MONTHLY_SEARCHES`.

order_type

Sort order for the returned keyword ideas. Defaults to `DESC`.