TOOL API

search_ad_negative_keyword_delete

Deletes Search Ads negative keywords for a campaign or ad group via /open_api/v1.3/search_ad/negative_keyword/delete/. Set `object_type` to specify whether the target object is a campaign or ad group, then provide the matching `object_id`. To obtain valid negative keyword IDs before deletion, use /search_ad/negative_word/get/.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

keyword_idsrequired

IDs of the negative keywords to delete. Maximum 1,000 IDs. To obtain valid negative keyword IDs, use /search_ad/negative_word/get/. If any specified negative keyword ID does not exist, the request returns an error.

object_idrequired

ID of the object whose negative keywords you want to delete. Provide this value according to `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 delete negative keywords at the campaign level or ad group level. This field determines the required ID type for `object_id`: `CAMPAIGN` requires a campaign ID, and `ADGROUP` requires an ad group ID.