TOOL API

search_ad_negative_keyword_add

Creates Search Ads negative keywords for campaigns or ad groups. If a user's search term matches a negative keyword, the ad in that campaign or ad group will not be shown. Before using this endpoint, Automatic Search Placement must already be enabled: for ad-group negative keywords, it must be enabled on the target ad group; for campaign negative keywords, it must be enabled for at least one ad group in the target campaign. See Create Search Ads: https://business-api.tiktok.com/portal/docs?id=1780164603696130.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

keywordsrequired

List of negative keywords to create. Max size: 1,000. For each ad group, you can configure a maximum of 10,000 negative keywords.

object_idsrequired

Campaign IDs or ad group IDs to which the negative keywords will be applied. Max size: 50. Specify values according to `object_type`: if `object_type` is `CAMPAIGN`, provide campaign IDs; if `object_type` is `ADGROUP`, provide ad group IDs.

object_typerequired

Specifies whether to create negative keywords for campaigns or ad groups. Use `CAMPAIGN` for campaigns or `ADGROUP` for ad groups. This value determines what IDs must be provided in `object_ids`.

replace

Whether to replace all existing negative keywords on the specified campaign or ad group with the values in `keywords`. `true` replaces all existing negative keywords; `false` adds new negative keywords. Default value: `false`.