TOOL API

tool_targeting_info_get

Gets details for targeting tags by ID, including location IDs, zip code IDs (US only), postal code IDs (Canada, Brazil, Indonesia, Thailand, and Vietnam only), and ISP IDs. Use this endpoint instead of /tool/region/ to retrieve zip code or postal code details. This endpoint must be called with POST because URL length limits make GET unsuitable. Supported parameter combinations depend on the targeting tag type: for ZIP/location tags, `scene` must be `GEO`; for ISP tags, `scene` must be `ISP`.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

brand_safety_partner

Brand safety partner. Required only when `brand_safety_type` is `THIRD_PARTY`. Pre-bid third-party brand safety solutions are allowlist-only features.

brand_safety_type

Brand safety type. Valid only when `scene` is `GEO` and `placements` includes `PLACEMENT_TIKTOK`. Default: `NO_BRAND_SAFETY`. `NO_BRAND_SAFETY` uses no brand safety solution. `EXPANDED_INVENTORY`, `STANDARD_INVENTORY`, and `LIMITED_INVENTORY` use TikTok brand safety inventory levels. `THIRD_PARTY` uses a third-party brand safety solution and requires `brand_safety_partner`. In the next API version, `EXPANDED_INVENTORY` will replace `NO_BRAND_SAFETY` as the default. To get countries and regions available for your brand safety settings, use /tool/region/. 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_type

Campaign objective. Required when `scene` is `GEO`. Allowed values: `REACH`, `TRAFFIC`, `VIDEO_VIEWS`, `LEAD_GENERATION`, `ENGAGEMENT`, `APP_PROMOTION`, `WEB_CONVERSIONS`, `PRODUCT_SALES`.

operating_system

Device operating system to target. Valid only when `scene` is `GEO`.

placements

Apps where you want to deliver ads. Required when `scene` is `GEO`. If you want information for zip code IDs or postal code IDs to be used for zip/postal code targeting, this field must include `PLACEMENT_TIKTOK`.

promotion_type

Promotion type. Required when `scene` is `GEO` and `objective_type` is not `REACH`, `VIDEO_VIEWS`, or `ENGAGEMENT`. Use this field to specify where you want to promote your products.

scene

Targeting type for the specified `targeting_ids`. `GEO` = geographical targeting, including administrative regions and zip/postal codes; `ISP` = internet service provider targeting. Default: `GEO`. Must be `GEO` for zip code, postal code, and location IDs, and `ISP` for ISP IDs.

targeting_idsrequired

Targeting tag IDs to look up. You can pass location IDs, zip code IDs, postal code IDs, a combination of location IDs and zip/postal code IDs, or ISP IDs. Max size: 1,000. Obtain location, zip code, and postal code IDs from `geo_id` returned by /tool/targeting/search/ or location IDs from `location_id` returned by /tool/region/. Obtain ISP IDs from `isp_id` returned by /tool/targeting/list/.