TOOL API

tool_interest_keyword_recommend_search

Searches for additional interest categories related to one or more seed keywords. You can provide either `keyword` or `keywords`; each seed keyword is used to generate related additional interest categories. Returned `keyword_id` values whose `status` is `EFFECTIVE` can be passed to the `interest_keyword_ids` field in `/adgroup/create/` to target audiences in an ad group. TikTok recommends using the Consolidated Interest and Behavior API at `/targeting/search/` to search for or list targeting categories and hashtags for interests and behaviors.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

audience_type

Audience type. Default value: `GENERAL_INTEREST`. `GENERAL_INTEREST` means the audience has a general, long-term interest in a video category. `PURCHASE_INTENTION` is deprecated and means the audience's recent behavior suggests they may buy something related to a content category.

keyword

Either `keyword` or `keywords` must be set. If both `keywords` and `keyword` are passed, `keyword` is ignored. Provide one seed keyword to search for related additional interest categories.

keywords

Either `keywords` or `keyword` must be set. If both `keywords` and `keyword` are passed, `keyword` is ignored. Provide up to 10 seed keywords; each keyword is processed separately to generate corresponding additional interest categories.

language

Keyword language. Default value: `en`. Target audience languages are not limited by the keyword language; for example, you can use English categories to target audiences that do not speak English.

limit

Number of additional interest categories to return. Default value: 50. Value range: 1-50.

mode

Search mode. Default value: `FUZZ_MATCH`.