TOOL API

search_ad_negative_keyword_update

Updates a Search Ads negative keyword at the campaign or ad group level via `/open_api/v1.3/search_ad/negative_keyword/update/`. Set `object_type` to identify whether the negative keyword belongs to a campaign or an ad group, provide the corresponding `object_id`, and specify the existing negative keyword with `old_keyword_id`.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

keywordrequired

Updated values for the original negative keyword.

object_idrequired

Campaign ID or ad group ID for the object whose negative keyword you want to update. This field depends on `object_type`: if `object_type` is `CAMPAIGN`, pass a campaign ID; if `object_type` is `ADGROUP`, pass an ad group ID.

object_typerequired

Specifies whether to update a negative keyword for a campaign or an ad group. This field determines what ID must be passed in `object_id`: `CAMPAIGN` requires a campaign ID, and `ADGROUP` requires an ad group ID.

old_keyword_idrequired

ID of the existing negative keyword to update. Obtain this ID from `/search_ad/negative_word/get/`. If the specified negative keyword ID does not exist, the request returns an error.