TOOL 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 credits

Call information

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

Input parameters

advertiser_idrequired

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.

keywordsrequired

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`.