← 返回目录
📁 API Reference › Tools

获取不同设置下可用的地域

此接口可用于根据推广目标、广告位、可选的定向操作系统、品牌安全设置，获取可投放广告的地域代码。
若想根据广告主 ID 获取可投放广告的可用地域，需使用 /search/region/ 接口。

注意

  • 针对最新开展业务的国家或地区（阿塞拜疆、保加利亚、玻利维亚、塞浦路斯、阿尔及利亚、爱沙尼亚、克罗地亚、肯尼亚、斯里兰卡、立陶宛、拉脱维亚、尼日利亚、波多黎各、巴拉圭、塞尔维亚、斯洛文尼亚、斯洛伐克）在 TikTok 广告位上定向投放使用 TRAFFIC、LEAD_GENERATION、APP_PROMOTION 或 WEB_CONVERSIONS 推广目标的广告，目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。你需要为每个最新开展业务的国家或地区单独申请白名单。
  • 针对最新开展业务的国家或地区（阿塞拜疆、保加利亚、玻利维亚、塞浦路斯、阿尔及利亚、爱沙尼亚、克罗地亚、肯尼亚、斯里兰卡、立陶宛、拉脱维亚、波多黎各、巴拉圭、塞尔维亚、斯洛文尼亚、斯洛伐克）在 TikTok 广告位上定向投放使用 REACH、VIDEO_VIEWS 或 ENGAGEMENT 推广目标的广告，目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。你需要为每个最新开展业务的国家或地区单独申请白名单。
    • 如果你针对这些国家或地区定向投放使用 REACH、VIDEO_VIEWS 或 ENGAGEMENT 推广目标的广告，不支持出价前第三方品牌安全解决方案。因此，无法将 brand_safety_type 设置为 THIRD_PARTY。

地域层级结构如下图所示。省/州、DMA（指定市场区域）和大都市属于同一层级。省/州、市和区属于行政区域，因此它们的 area_type 为 ADMIN。对于 DMA 和大都市，area_type 为 METROPOLITAN_OR_DMA。

v1.2 与 v1.3 接口对比

下表概述了 v1.2 接口与 v1.3 接口之间的差异。 ``xtable |变更{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/tools/regions/|/v1.3/tool/region/| |请求参数名称| <ul><li>placement</li><li>brand_safety|<ul><li>placements</li><li>brand_safety_type| |请求参数类型 |advertiser_id: number|advertiser_id: string| |新增请求参数 |/|rf_campaign_type<br>promotion_target_type<br>shopping_ads_type<br>promotion_type<br>language<br>app_promotion_type| |返回参数类型|<ul><li>parent_id: number</li><li>next_level_ids: number[]|<ul><li>parent_id: string</li><li>next_level_ids: string[]| |返回参数名称和类型|id（在region_info对象中)：number|location_id`: string|


## 请求

**地址** <https://business-api.tiktok.com/open_api/v1.3/tool/region/>

**方法** GET

**Header**

```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。 |

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID |
|placements {必填}|string[]| 你希望投放广告的应用。枚举值参见[枚举值 - 广告位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|objective_type {必填}|string| 推广目标类型。枚举值及其描述参见[推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737585562434561)。|
|app_promotion_type {+条件必填}|string|当 `objective_type` 为 `APP_PROMOTION` 时，此为必填字段。<br><br>应用推广类型。<br><br>枚举值：<ul><li>`APP_INSTALL`：应用安装。吸引新用户安装你的应用。</li><li>`APP_RETARGETING`：应用再营销。重新吸引现有应用用户在你的应用中采取行动。</li><li>`APP_PREREGISTRATION`：应用预注册。让新用户在你的应用发布前完成预注册。若想了解如何创建手动应用预注册广告，参见[此处](https://business-api.tiktok.com/portal/docs/create-app-pre-registration-ads/v1.3)。</li><li>`MINIS`：TikTok Minis 或剧集。通过优化自然流量和广告流量，推广你的剧集、短剧或小游戏。<ul><li>如需详细了解支持此设置的推广系列类型，参见[创建升级版 Smart+ TikTok Growth Max 短剧推广系列](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-minis-campaign/v1.3)和[创建升级版 Smart+ TikTok Growth Max 剧集推广系列](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-mini-series-feed-campaign/v1.3)。</li></ul></li></ul>|
|level_range|string| 你希望获取的地域层级。枚举值： <ul><li>`ALL`：所有层级。</li><li>`TO_COUNTRY`：仅国家或地区层级。</li><li> `TO_PROVINCE`：国家/地区和省/州层级；DMA 和大都市属于省/州层级。</li><li>`TO_CITY`：国家/地区、省/州和市层级。</li><li>`TO_DISTRICT`：国家/地区、省/州、市和区层级。</li></ul>|
|language|string|返回的地域名称 (`name`) 的语言。<br><br>默认值：`en`（英语）。<br><br>若想查找允许的值，参见 <a href="#item-link-List of values for language">`language` 值列表</a>。<br><br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>如果不支持传入的语言，该语言将被忽略并使用默认值 `en`。</li><li>如果传入支持的非英语语言，可能不会翻译与该语言对应的国家或地区之外的地域名称。例如，如果将 `language` 设置为 `ja`（日语），可能不会翻译日本以外的地域名称。</li></ul>|
|shopping_ads_type |string|仅当 `objective_type` 为 `PRODUCT_SALES` 时生效。<br><br>购物广告类型。<br><br>枚举值： <ul><li>`VIDEO`：视频购物广告。</li><li>`LIVE`：直播购物广告。</li><li>`PRODUCT_SHOPPING_ADS`：商品购物广告。</li></ul> <br>若想了解不同购物广告类型的简介，以及创建[视频购物广告](1741942291730434.html)、[直播购物广告](1754162402455554.html)和[商品购物广告](1785886237030401.html)的步骤，参见[创建购物广告](1741942179356738.html)。|
|promotion_type|string|推广类型（优化位置）。<br><br>枚举值参见[枚举值 - 推广类型](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Promotion%20Type)。 |
|promotion_target_type |string| 当 `objective_type` 为 `LEAD_GENERATION` 时生效。<br>线索收集推广目标的推广类型。<br>枚举值： <ul><li> `INSTANT_PAGE`：即时表单。创建可快速加载的应用内 TikTok 即时表单来收集更多线索。</li><li> `EXTERNAL_WEBSITE`：网站表单。使用包含网站表单的落地页，或使用 TikTok 即时体验页面（可跳转到包含网站表单的网站），收集更多线索。</li></ul> |
|operating_system|string| 你希望定向的操作系统。枚举值：`ANDROID`、`IOS`。|
|brand_safety_type|string|品牌安全类型。仅当 `placements` 设置为 `PLACEMENT_TIKTOK` 时生效。默认值：`NO_BRAND_SAFETY`。枚举值： <ul><li>`NO_BRAND_SAFETY`： 不使用任何品牌安全解决方案。 使用全部库存，意味着你的广告可能会展示在某些成人主题的内容前后。 </li><li>`EXPANDED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用扩展库存，意味着你的广告将展示在已移除大部分不当内容、不包含成人主题的内容前后。在下一个 API 版本中，`EXPANDED_INVENTORY` 将替代 `NO_BRAND_SAFETY`，并成为默认的品牌安全选项。</li><li>`STANDARD_INVENTORY`：使用 TikTok 品牌安全解决方案。使用标准库存，意味着你的广告将展示在适合大多数品牌的内容前后。 </li><li>`LIMITED_INVENTORY`：使用 TikTok 品牌安全解决方案。使用有限库存，意味着你的广告将不会展示在包含成人主题的内容前后。</li><li>`THIRD_PARTY`：使用第三方品牌安全解决方案。你还需向 `brand_safety_partner` 字段传入一个值。</li></ul> <br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 针对竞价广告、适用于 `APP_PROMOTION`、`WEB_CONVERSIONS`、`TRAFFIC`、`LEAD_GENERATION`  推广目标的出价前第一方品牌安全解决方案和出价前第三方品牌安全解决方案目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。 </li><li> 如需了解支持出价前品牌安全筛选功能的推广目标，参见[品牌安全](https://ads.tiktok.com/marketing_api/docs?id=1739381752981505)。 </li></ul>|
|brand_safety_partner{+条件必填}|string|品牌安全合作伙伴。当 `brand_safety_type` 为 `THIRD_PARTY` 时，此为必填字段，且 `placements` 需要设置为 `PLACEMENT_TIKTOK`。枚举值：`IAS`、`OPEN_SLATE`（此合作伙伴在 TikTok 广告管理平台上显示为 <strong>DoubleVerify</strong>，因为其已被 DoubleVerify 收购)。<br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 出价前第三方品牌安全解决方案目前为白名单功能。如需使用这些功能，请联系你的 TikTok 销售代表。 |
|rf_campaign_type |string| 将 `objective_type` 指定为 `RF_REACH` 时，使用此字段将推广系列设置为 TikTok Pulse 推广系列，即可获取可用的高级内容标签。<br><br>枚举值：`STANDARD`（覆盖和频次推广系列）、`PULSE`（TikTok Pulse 推广系列）。<br><br>如果将此字段设置为 `PULSE`，将仅返回一个地域 ID (`location_id`)。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>未将 `objective_type` 指定为 `RF_REACH` 时，请勿传入此字段。</li><li>当使用 [/adgroup/rf/create/](https://ads.tiktok.com/marketing_api/docs?id=1738235338194945) 接口创建 TikTok Pulse 广告组时，需将此接口返回的 `location_id` 值传入 `location_ids`。</li></ul>|

language 值列表

| 值 {20%}| 描述{60%}|
|---|---|
| `af` | 阿非利堪斯语 |
| `am` | 阿姆哈拉语 |
| `ar` | 阿拉伯语 |
| `az` | 阿塞拜疆语 |
| `be` | 白俄罗斯语 |
| `bg` | 保加利亚语 |
| `bn` | 孟加拉语 |
| `bs` | 波斯尼亚语 |
| `ca` | 加泰罗尼亚语 |
| `cs` | 捷克语 |
| `da` | 丹麦语 |
| `de` | 德语 |
| `el` | 希腊语 |
| `en` | 英语 |
| `es` | 西班牙语 |
| `et` | 爱沙尼亚语 |
| `eu` | 巴斯克语 |
| `fa` | 波斯语 |
| `fi` | 芬兰语 |
| `fil` | 菲律宾语 |
| `fr` | 法语 |
| `gl` | 加利西亚语 |
| `gu` | 古吉拉特语 |
| `hi` | 印地语 |
| `hr` | 克罗地亚语 |
| `hu` | 匈牙利语 |
| `hy` | 亚美尼亚语 |
| `id` | 印尼语 |
| `is` | 冰岛语 |
| `it` | 意大利语 |
| `ja` | 日语 |
| `ka` | 格鲁吉亚语 |
| `kk` | 哈萨克语 |
| `km` | 高棉语 |
| `kn` | 卡纳达语 |
| `ko` | 韩语 |
| `ky` | 吉尔吉斯语 |
| `lo` | 老挝语 |
| `lt` | 立陶宛语 |
| `lv` | 拉脱维亚语 |
| `mk` | 马其顿语 |
| `ml` | 马拉雅拉姆语 |
| `mn` | 蒙古语 |
| `mr` | 马拉地语 |
| `ms` | 马来语 |
| `my` | 缅甸语 |
| `ne` | 尼泊尔语 |
| `nl` | 荷兰语 |
| `no` | 挪威语 |
| `pa` | 旁遮普语 |
| `pl` | 波兰语 |
| `pt` | 葡萄牙语 |
| `pt-BR` | 葡萄牙语（巴西） |
| `ro` | 罗马尼亚语 |
| `ru` | 俄语 |
| `si` | 僧伽罗语 |
| `sk` | 斯洛伐克语 |
| `sl` | 斯洛文尼亚语 |
| `sq` | 阿尔巴尼亚语 |
| `sr` | 塞尔维亚语 |
| `sv` | 瑞典语 |
| `sw` | 斯瓦希里语 |
| `ta` | 泰米尔语 |
| `te` | 泰卢固语 |
| `th` | 泰语 |
| `tr` | 土耳其语 |
| `uk` | 乌克兰语 |
| `ur` | 乌尔都语 |
| `uz` | 乌兹别克语 |
| `vi` | 越南语 |
| `zh` | 中文 |
| `zh-CN` | 简体中文 |
| `zh-HK` | 香港繁体中文 |
| `zh-TW` | 繁体中文 |
| `zu` | 祖鲁语 |

示例

(code cURL HTTP)
curl --location -g --request GET 'https://business-api.tiktok.com/open_api/v1.3/tool/region/?advertiser_id={ADVERTISER_ID}}&placements=["PLACEMENT_TIKTOK"]&objective_type={{objective_type}}' \
--header 'Access-Token: xxxx' \
--header 'Content-Type: application/json' \
(/code)

返回

|字段|类型|描述|
|---|---|---|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据。 |
#|region_list|string[]| 国家或地区代码列表 |
#|region_info|object[]| 可用地域的相关信息|
##|location_id|string| 地域 ID|
##|name|string|地域名称|
##|parent_id|string| 上级地域 ID。如果没有上级地域，返回 0|
##|region_code|string|国家或地区代码。例如“DE”。|
##|next_level_ids|string[]|下级地域列表。|
##|area_type|string| 地域类型。枚举值：`ADMIN`、`METROPOLITAN_OR_DMA`。|
##|level|string|地域层级。枚举值：`COUNTRY`（国家或地区层级）、`PROVINCE`、`CITY`（市或县层级）、`DISTRICT`（区或市层级）。DMA 和大都市属于省/州层级。|
##|support_below_18|boolean|该地域是否允许面向未满 18 岁用户投放广告。|
|request_id|string| 请求的日志 ID，唯一标识一个请求。|

示例

(code JSON json)
{
    "code": 0,
    "message": "OK",
    "request_id": "2022070115265201024524610404180ECA",
    "data": {
        "region_info": [
            {
                "next_level_ids": [],
                "area_type": "ADMIN",
                "level": "COUNTRY",
                "region_code": "PE",
                "location_id": "3932488",
                "name": "Peru",
                "parent_id": "0",
                "support_below_18": true
            },
            {
                "next_level_ids": [
                    "662",
                    "525",
                    "532",
                    ...
                ],
                "area_type": "ADMIN",
                "level": "COUNTRY",
                "region_code": "US",
                "location_id": "6252001",
                "name": "United States",
                "parent_id": "0",
                "support_below_18": true
            },
            ...
        ],
        "region_list": [
            "PE",
            "US",
            "CL",
            "MX",
            "BY",
            "VN",
            ...
        ]
    }
}
(/code)
← 根据 ID 获取地域定向标签的信息获取一般兴趣分类列表 →

内容来源：TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了？
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →