TOOL API

tool_region_get

Gets available ad delivery locations based on objective, placements, and optional targeting constraints such as operating system and brand safety settings. Use this endpoint when availability depends on delivery settings; if you need locations based on advertiser IDs, use /search/region/. Some newly available countries or regions are allowlist-only depending on objective and placement: for `TRAFFIC`, `LEAD_GENERATION`, `APP_PROMOTION`, or `WEB_CONVERSIONS` with TikTok placement, and for `REACH`, `VIDEO_VIEWS`, or `ENGAGEMENT` with TikTok placement, access is gated separately per country or region. For those newly available countries or regions with `REACH`, `VIDEO_VIEWS`, or `ENGAGEMENT`, pre-bid third-party brand safety is not supported, so `brand_safety_type` cannot be `THIRD_PARTY`. Pre-bid first-party Brand Safety for `APP_PROMOTION`, `WEB_CONVERSIONS`, `TRAFFIC`, and `LEAD_GENERATION` in Auction ads, and pre-bid third-party brand safety solutions, are also allowlist-only features.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

app_promotion_type

string

brand_safety_partner

Brand safety partner. Required when `brand_safety_type` is `THIRD_PARTY`, and `placements` must be `PLACEMENT_TIKTOK`. Pre-bid third-party brand safety is allowlist-only.

brand_safety_type

Brand safety setting. Valid only when `placements` is `PLACEMENT_TIKTOK`. Default is `NO_BRAND_SAFETY`. If set to `THIRD_PARTY`, you must also provide `brand_safety_partner`. For newly available countries or regions targeted with `REACH`, `VIDEO_VIEWS`, or `ENGAGEMENT`, `THIRD_PARTY` is not supported. Pre-bid first-party Brand Safety for `APP_PROMOTION`, `WEB_CONVERSIONS`, `TRAFFIC`, and `LEAD_GENERATION` in Auction ads, and pre-bid third-party brand safety, are allowlist-only. `EXPANDED_INVENTORY` will replace `NO_BRAND_SAFETY` and become the default in the next API version.

language

Language for the returned location name (`name`). Default is `en`. If the specified language is unsupported, it is ignored and `en` is used. If you specify a supported non-English language, locations outside that language's native country or region might not be translated.

level_range

Maximum location level to return. `ALL`: all levels. `TO_COUNTRY`: only country or region. `TO_PROVINCE`: country and province; DMA and Metropolitan are treated as province level. `TO_CITY`: country, province, and city. `TO_DISTRICT`: country, province, city, and district.

objective_typerequired

Advertising objective. This field controls other parameters: `shopping_ads_type` is valid only when `objective_type` is `PRODUCT_SALES`; `promotion_target_type` is valid only when `objective_type` is `LEAD_GENERATION`; `rf_campaign_type` must be used only when `objective_type` is `RF_REACH`. Newly available countries or regions are allowlist-only for `TRAFFIC`, `LEAD_GENERATION`, `APP_PROMOTION`, and `WEB_CONVERSIONS` with TikTok placement, and separately allowlist-only for `REACH`, `VIDEO_VIEWS`, and `ENGAGEMENT` with TikTok placement. For those newly available countries or regions with `REACH`, `VIDEO_VIEWS`, or `ENGAGEMENT`, `brand_safety_type` cannot be `THIRD_PARTY`.

operating_system

Operating system to target.

placementsrequired

Apps where you want to deliver ads. `brand_safety_type` and `brand_safety_partner` are valid only when `placements` includes `PLACEMENT_TIKTOK`.

promotion_target_type

Promotion target type for Lead Generation. Valid only when `objective_type` is `LEAD_GENERATION`. `INSTANT_PAGE` uses an in-app TikTok Instant Form. `EXTERNAL_WEBSITE` uses a landing page with a Website Form or a TikTok Instant Page that redirects to a website form.

promotion_type

Promotion type (optimization location).

rf_campaign_type

Used only when `objective_type` is `RF_REACH`. Set to `PULSE` to get available premium contextual tags for a TikTok Pulse campaign; when `PULSE` is used, only one `location_id` is returned. Do not pass this field when `objective_type` is not `RF_REACH`. The returned `location_id` must be passed as `location_ids` to /adgroup/rf/create/ when creating a TikTok Pulse ad group.

shopping_ads_type

Shopping ads type. Valid only when `objective_type` is `PRODUCT_SALES`.