TOOL API

tiktok_inventory_filters_update

Sets or updates an ad account's Brand Safety Hub settings, which define default first-party brand safety controls at the account level, including TikTok Inventory Filter and suitability controls such as Category Exclusion and Vertical Sensitivity. If you update brand safety settings, you must submit `brand_safety_type`, `category_exclusion_ids`, and `vertical_sensitivity_id` together. Settings configured through this endpoint automatically apply to future Smart+ Campaigns, but do not apply to future regular campaigns created with `/campaign/create/`.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

brand_safety_type

Inventory filter tier applied to placements in the For You, Following, and Profile Page feeds, and in Search feed where ads appear next to viewed search results. If you want to update the brand safety settings, you must specify `brand_safety_type`, `category_exclusion_ids`, and `vertical_sensitivity_id` simultaneously.

category_exclusion_ids

List of content category IDs to avoid. Valid only when `brand_safety_type` is `STANDARD_INVENTORY` or `LIMITED_INVENTORY`. To obtain valid IDs, call `/tool/content_exclusion/get/` and use the returned `excluded_category_list`. Currently, category exclusion is not available for the Product Sales objective.

cover_all_ad_objectivesrequired

Whether to apply the brand safety settings (`brand_safety_type`, `category_exclusion_ids`, and `vertical_sensitivity_id`) to all advertising objectives. `true` applies them to all objectives, including Reach, Video Views, Community Interaction, Traffic, App Promotion, Lead Generation, Website Conversions, and Product Sales. `false` applies them only to Reach, Video Views, and Community Interaction. Once set to `true`, this field cannot be updated back to `false`.

vertical_sensitivity_id

Vertical category ID used to exclude sensitive vertical-related content. Valid only when `brand_safety_type` is `STANDARD_INVENTORY` or `LIMITED_INVENTORY`. To obtain valid IDs, call `/tool/content_exclusion/get/` and use the returned `vertical_sensitivity_list`. Vertical sensitivity controls are not available for Traffic, App Promotion, Lead Generation, Website Conversions, and Product Sales objectives.