TOOL API
tool_
Returns contextual tags available for targeting for the specified advertiser, advertising objective, and optional region codes. Contextual targeting is currently an allowlist-only feature; if you need access, contact your TikTok representative. This endpoint also supports brand safety filtering, and some pre-bid first-party Brand Safety solutions for `APP_PROMOTION`, `WEB_CONVERSIONS`, `TRAFFIC`, and `LEAD_GENERATION` objectives in Auction ads, as well as pre-bid third-party brand safety solutions, are allowlist-only.
Call information
- Tool slug
- tiktok-ads.tool_contextual_tag_get
- Provider
- TikTok for Business
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
advertiser_idrequiredAdvertiser ID.
brand_safety_typeBrand safety type. Defaults to `STANDARD_INVENTORY` if omitted. `EXPANDED_INVENTORY` means ads can appear next to content where most inappropriate content has been removed and may still contain some mature themes; in the next API version, `EXPANDED_INVENTORY` will replace `NO_BRAND_SAFETY` and become the default option. `STANDARD_INVENTORY` means ads appear next to content appropriate for most brands. `LIMITED_INVENTORY` means ads will not appear next to content containing mature themes. Pre-bid first-party Brand Safety solutions for `APP_PROMOTION`, `WEB_CONVERSIONS`, `TRAFFIC`, and `LEAD_GENERATION` objectives in Auction ads, and pre-bid third-party brand safety solutions, are allowlist-only features.
objective_typerequiredAdvertising objective. Only supports `REACH`, `VIDEO_VIEWS`, and `RF_REACH`. If `objective_type` is `RF_REACH`, you may also use `rf_campaign_type` to request premium contextual tags for TikTok Pulse campaigns.
region_codesCountry or region codes used to filter available contextual tags.
rf_campaign_typeValid only when `objective_type` is `RF_REACH`. Use this field to set the campaign as a TikTok Pulse campaign so you can get available premium contextual tags. Do not pass this field when `objective_type` is not `RF_REACH`.