← 返回目录
📁 API Reference › Tools

搜索地域定向标签

您可以使用本接口通过关键词搜索定向标签。

本接口可搜索两种用于定向受众的定向标签：邮政编码 ID（目前仅支持美国、加拿大、巴西、印度尼西亚、泰国、越南）和地域 ID。若要将定向标签应用于广告中，需在调用/adgroup/create/，/adgroup/update/，或/ad/audience_size/estimate/时，将本接口返回的邮政编码 ID 传给zipcode_ids字段，或将地域 ID 传给location_ids字段。

请注意，/tool/region/和/tool/targeting/search/接口均可用于获取地域 ID。

注意

  • 本接口需使用 POST 方法，因为 GET 请求会导致 URL 长度受限。
  • 巴西、印度尼西亚、泰国、越南的邮政编码定向目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。
  • 使用推广目标TRAFFIC、 LEAD_GENERATION、 APP_PROMOTION 或 WEB_CONVERSIONS以及 TikTok 版位时定向新开放的国家或地区（阿塞拜疆、保加利亚、玻利维亚、塞浦路斯、阿尔及利亚、爱沙尼亚、克罗地亚、肯尼亚、斯里兰卡、立陶宛、拉脱维亚、尼日利亚、波多黎各、巴拉圭、塞尔维亚、斯洛文尼亚、斯洛伐克）目前为单独的白名单功能。如需使用这些功能，请联系您的 TikTok 销售代表。您需要为每个新开放的国家或地区单独申请白名单。
  • 使用推广目标REACH、VIDEO_VIEWS 或 ENGAGEMENT 以及 TikTok 版位时定向新开放的国家或地区（阿塞拜疆、保加利亚、玻利维亚、塞浦路斯、阿尔及利亚、爱沙尼亚、克罗地亚、肯尼亚、斯里兰卡、立陶宛、拉脱维亚、波多黎各、巴拉圭、塞尔维亚、斯洛文尼亚、斯洛伐克）目前为单独的白名单功能。如需使用这些功能，请联系您的 TikTok 销售代表。您需要为每个新开放的国家或地区单独申请白名单。
    • 当您定向这些国家或地区且同时使用推广目标REACH、VIDEO_VIEWS 或 ENGAGEMENT时，不支持出价前第三方品牌安全产品。因此，不支持同时将brand_safety_type设置为 THIRD_PARTY。

请求

地址: https://business-api.tiktok.com/open_api/v1.3/tool/targeting/search/

方法: POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
| advertiser_id {必填} | string | 广告主ID。 |
| objective_type {必填} | string | 推广目标。<br><br>允许的枚举值：`REACH`，`TRAFFIC`，`VIDEO_VIEWS`，`LEAD_GENERATION`，`ENGAGEMENT`，`APP_PROMOTION`，`WEB_CONVERSIONS`，`PRODUCT_SALES`。<br><br>枚举值的描述请查看[推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737585562434561)。|
|promotion_type {+条件必填} |string|推广对象类型。若对应的推广系列推广目标不是`REACH`，`VIDEO_VIEWS`或`ENGAGEMENT`，则此字段必填。<br>枚举值详见 [枚举值-推广对象类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。|
|placements {必填}|string[]|广告版位。<br><br>枚举值请查看[枚举值-版位](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。<br><p><span style="color:darkred"><b>注意</b></span>：若您希望模糊搜索单个邮政编码 ID，随后将该 ID 用于邮政编码定向，本字段的值需包含`PLACEMENT_TIKTOK`。 |
| search_type {必填} | string | 搜索类型。<br><br>枚举值：<ul><li>`FUZZY_SEARCH`：对单个地域 ID 或邮政编码 ID 进行模糊搜索。<br>对于此搜索类型，您仅可向 `keywords` 字段传入一个关键词，最多返回100条搜索结果。</li><li>`BATCH_REGION_SEARCH`：对多个地域ID进行批量模糊搜索。<br> 对于此搜索类型，您最多可向 `keywords` 字段传入1,000个关键词，最多为每个关键词返回5条按相关度排序的搜索结果。</li><li>`BATCH_ZIPCODE_SEARCH` :  对多个邮政编码ID进行批量精确搜索。<br>对于此搜索类型，您最多可向 `keywords` 字段传入1,000个关键词，最多为每个关键词返回 1 条搜索结果，或无匹配结果时返回 0 条搜索结果。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>巴西、印度尼西亚、泰国、越南的邮政编码定向目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>枚举值`BATCH_ZIPCODE_SEARCH`和`BATCH_REGION_SEARCH`仅可用于搜索邮政编码 ID 或地域 ID，而`FUZZY_SEARCH`可用于搜索单个邮政编码 ID 或地域 ID。</li></ul> |
| keywords {必填} | string[] | 用于搜索定向标签的关键词列表。<br><br>长度限制：<ul><li>`search_type` 为 `FUZZY_SEARCH`时为1。</li><li>`search_type`为`BATCH_REGION_SEARCH`或 `BATCH_ZIPCODE_SEARCH`时为1,000。</li></ul><br>若您将`search_type`设置为`BATCH_ZIPCODE_SEARCH`，您需传入邮政编码作为关键词，因为此搜索类型仅支持精确搜索。<ul><li>对于美国邮政编码定向，请传入 5 位美国邮政编码作为关键词。示例：`["10001","10002"]`。</li><li>对于加拿大邮政编码定向，请传入加拿大邮政编码的前 3 个字符（前分拣区）作为关键词。示例：`["A0A","A0B"]`。</li><li>对于巴西邮政编码定向，请传入巴西邮政编码的前 5 位数字作为关键词。示例：`["81480","18072"]`。</li><li>对于印度尼西亚邮政编码定向，请传入 5 位的印度尼西亚邮政编码作为关键词。示例：`["20371","12120"]`。</li><li>对于泰国邮政编码定向，请传入 5 位的泰国邮政编码作为关键词。示例：`["30000","40000"]`。</li><li>对于越南邮政编码定向，请传入越南邮政编码的前 3 位数字作为关键词。示例：`["718","719"]`。</li></ul>|
| geo_types | string[] | 用于筛选结果的地域类型。<br>枚举值：`COUNTRY`（国家或地区），`PROVINCE`（省），`CITY`（城市/郡/县），`DISTRICT`（区/城市），`DMA`（指定市场区域），`ZIP_CODE`（邮政编码对应地域）。<ul><li> 当 `search_type`设置为`FUZZY_SEARCH`时，本字段允许值为`ZIP_CODE`，`COUNTRY`，`PROVINCE`，`CITY`，`DISTRICT`和`DMA`。</li><li>当 `search_type`设置为`BATCH_ZIPCODE_SEARCH`时，本字段允许值为`ZIP_CODE`。</li><li>当`search_type`设置为`BATCH_REGION_SEARCH`时，本字段允许值为`COUNTRY`，`PROVINCE`，`CITY`，`DISTRICT`和`DMA`。</li></ul> |
| region_codes {+Conditional} | string[] |用于筛选结果的定向国家或地区代码。<br><br><ul><li>当`search_type`设置为 `BATCH_ZIPCODE_SEARCH` 或`BATCH_REGION_SEARCH`时本字段必填，且只允许设置为`US`（美国）、 `CA`（加拿大）、`BR`（巴西）、`ID`（印度尼西亚）、`TH`（泰国）或  `VN` （越南）。</li><li> 当`search_type`设置为 `FUZZY_SEARCH`时，本字段可传，允许的国家或地区代码枚举值参见[附录-地区代码](https://ads.tiktok.com/marketing_api/docs?id=1737585867307010) 。</li></ul> |
| operating_system | string | 想要定向的受众设备的操作系统。枚举值：`ANDROID`，`IOS`。|
|brand_safety_type|string|品牌安全类型。仅当`placements`设置为`PLACEMENT_TIKTOK` 时生效。默认值：`NO_BRAND_SAFETY`。枚举值： <ul><li>`NO_BRAND_SAFETY`：不使用任何品牌安全解决方案，即使用<strong>全部库存</strong>。您的广告可能会在某些包含成人主题的内容周围展示。</li><li>`EXPANDED_INVENTORY`：使用TikTok的品牌安全解决方案，即使用<b>扩展库存</b>。您的广告将不会出现在不当内容或包含成人主题的内容后面。在下个API版本中`EXPANDED_INVENTORY`将替代`NO_BRAND_SAFETY`，并成为默认的品牌安全选项。</li><li>`STANDARD_INVENTORY`：使用TikTok的品牌安全解决方案中的<strong>标准库存</strong>。您的广告将展示在适合大多数品牌的内容周围。 </li><li>`LIMITED_INVENTORY`：使用TikTok的品牌安全解决方案中的<strong>有限库存</strong>。您的广告将展示在不包含成人主题的内容周围。</li><li>`THIRD_PARTY`：使用第三方品牌安全解决方案。若选择本选项，您需要向`brand_safety_partner`字段传入第三方合作伙伴名称。</li></ul>您可以使用[/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)接口查询品牌安全设置对应的广告可投放国家或地区。<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`）时必填。枚举值：`IAS`, `OPEN_SLATE`（该合作伙伴在TikTok广告管理平台的对应名称为<strong>DoubleVerify</strong>，因为该合作伙伴已被DoubleVerify收购）。如果需要获取自己的品牌安全设置可以投放的国家和地区，您可以使用`/tool/region/`接口。您需要传入品牌安全类型和品牌安全合作伙伴。<br><p><span style="color:darkred"><b>注意</b></span>：出价前第三方品牌安全解决方案目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。|

示例

搜索单个加拿大邮政编码 ID

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/tool/targeting/search/' \
--header 'Access-Token:  {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id":"{{advertiser_id}}",
    "objective_type":"{{objective_type}}",
    "placements":["PLACEMENT_TIKTOK"],
    "promotion_type":"{{promotion_type}}",
    "search_type":"FUZZY_SEARCH",
    "keywords":["A0A"],
    "region_codes":["CA"]
}'
(/code)

搜索单个美国邮政编码 ID

(code curl http)
curl --location "https://business-api.tiktok.com/open_api/v1.3/tool/targeting/search/" \
--header "Access-Token: {{Access-Token}}" \
--header "Content-Type: application/json" \
--data "{
    "advertiser_id":"{{advertiser_id}}",
    "objective_type":"{{objective_type}}",
    "placements":["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"],
    "promotion_type":"{{promotion_type}}",
    "search_type":"FUZZY_SEARCH",
    "keywords":["40601"]
}"
(/code)

批量搜索巴西邮政编码 ID

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tool/targeting/search/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id":"{{advertiser_id}}",
    "objective_type":"APP_PROMOTION",
    "placements":["PLACEMENT_TIKTOK"],
    "promotion_type":"APP_IOS",
    "search_type":"BATCH_ZIPCODE_SEARCH",
    "keywords":["81480","18072"],
    "region_codes":["BR"]
}'
(/code)

批量搜索地域ID

(code curl http)
curl --location "https://business-api.tiktok.com/open_api/v1.3/tool/targeting/search/" \
--header "Access-Token: {{Access-Token}}" \
--header "Content-Type: application/json" \
--data "{
    "advertiser_id":"{{advertiser_id}}",
    "objective_type":"{{objective_type}}",
    "placements":["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"],
    "promotion_type":"{{promotion_type}}",
    "search_type":"BATCH_REGION_SEARCH",
    "keywords":["Kentucky","Virginia"],
    "region_codes":["US"]
}"
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| targeting_tag_list | object[] |所指定的关键词所匹配到的定向标签的信息。 <br><p><span style="color:darkred"><b>注意</b></span>：对于同一个关键词（`keyword`）可能返回多个匹配到的定向标签，对应不同名称（`name`）。 |
##| keyword | string | 用于搜索定向标签的关键词。 |
##| targeting_type | string | 定向标签所适用的定向类型。<br>枚举值：`GEO` (地理位置定向，包括行政区域定向和邮政编码定向)。 |
##| name | string | 定向标签的名称。|
##| status_info | object | 定向标签的状态信息。|
###| status | string |定向标签的状态。<br>枚举值: `ENABLED`（可用于定向）, `DISABLED`（不可用于定向）。|
###| reason | string | 定向标签不可用于定向的原因。<br>仅当`status`为`DISABLED`时返回。<br>枚举值：<ul><li> `OFFLINE`：该定向标签已下线。 </li><li> `NOT_SUPPORTED`：该定向标签未下线，但在所选的设置下不支持。</li></ul> |
##| geo | object | 用于地域定向的定向标签的信息。<br>当`targeting_type`为`GEO`时返回。|
###| geo_id | string | 地域ID或邮政编码ID。 <br>地域ID可用于行政区域定向，邮政编码ID则可用于邮政编码定向。<ul><li>当对应的 `geo_type`为`ZIP_CODE`时，本字段的值为邮政编码ID，可在调用[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)，[/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745)，或[/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353)时传给`zipcode_ids`字段。</li><li> 当对应的 `geo_type`非 `ZIP_CODE`时，本字段的值为地域ID，可在调用[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)，[/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745)，或[/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353)时传给`location_ids` 字段。</li></ul>|
###| geo_type | string |`geo_id`对应的地域类型。<br>枚举值：`COUNTRY`（国家或地区），`PROVINCE`（省），`CITY`（城市/郡/县），`DISTRICT`（区/城市），`DMA`（指定市场区域），`ZIP_CODE`（邮政编码对应地域）。|
###| description | string | 所定向地域的描述。|
###| region_code | string | 该定向地域所属的国家或地区的代码。|
###| parent_id | string |父层级地域的ID。<br>若无对应父层级地域，则返回`0`。|
#| parent_tags | object[] | 所有父层级定向标签的相关信息。 |
##| targeting_type | string | 该父层级定向标签所适用的定向类型。<br>枚举值： `GEO `(地理位置定向，包括行政区域定向和邮政编码定向)。|
##| name | string | 该父层级定向标签的名称。|
##| status_info | object | 该父层级定向标签的状态信息。|
###| status | string | 该父层级定向标签的状态。<br>枚举值: `ENABLED` （可用于定向），`DISABLED`（不可用于定向）。 |
###| reason | string | 该父层级定向标签不可用于定向的原因。<br>仅当`status`为`DISABLED`时返回。<br>枚举值：<ul><li>`OFFLINE`：该父层级定向标签已下线。</li><li>`NOT_SUPPORTED`：该父层级定向标签未下线，但在所选的设置下不支持。</li></ul>  |
##| geo | object |用于地域定向的父层级定向标签的信息。<br>当`targeting_type`为`GEO`时返回。 |
###| geo_id | string | 父层级地域ID或邮政编码ID。<ul><li> 当对应的 `geo_type`为`ZIP_CODE`时，本字段的值可在调用[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)，[/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745)，或[/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353)时传给`zipcode_ids`字段。</li><li> 当对应的 `geo_type`非 `ZIP_CODE`时，本字段的值可在调用[/adgroup/create/](https://ads.tiktok.com/marketing_api/docs?id=1739499616346114)，[/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745)，或[/ad/audience_size/estimate/](https://ads.tiktok.com/marketing_api/docs?id=1740302379236353)时传给`location_ids` 字段。</li></ul>|
###| geo_type | string | `geo_id`对应的地域类型。<br>枚举值：`COUNTRY`（国家或地区），`PROVINCE`（省），`CITY`（城市/郡/县），`DISTRICT`（区/城市），`DMA`（指定市场区域），`ZIP_CODE`（邮政编码对应地域）。 |
###| description | string | 该父层级地域的描述。 |
###| region_code | string | 该父层级地域所属的国家或地区的代码。|
###| parent_id | string | 该父层级地域所对应的父层级地域的ID。<br>若无对应父层级地域，则返回`0`。 |

示例

搜索单个加拿大邮政编码 ID

(code Success-Response http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "parent_tags": [
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "geo": {
                    "geo_id": "6251999",
                    "geo_type": "COUNTRY",
                    "parent_id": "0",
                    "region_code": "CA",
                    "description": "Country"
                },
                "isp": null,
                "name": "Canada",
                "targeting_type": "GEO"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "geo": {
                    "geo_id": "6354959",
                    "geo_type": "PROVINCE",
                    "parent_id": "6251999",
                    "region_code": "CA",
                    "description": "province"
                },
                "isp": null,
                "name": "Newfoundland and Labrador",
                "targeting_type": "GEO"
            }
        ],
        "targeting_tag_list": [
            {
                "keyword": "A0A",
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "geo": {
                    "geo_id": "8124000000533",
                    "geo_type": "ZIP_CODE",
                    "parent_id": "6354959",
                    "region_code": "CA",
                    "description": "postcode"
                },
                "isp": null,
                "name": "A0A",
                "targeting_type": "GEO"
            }
        ]
    }
}
(/code)

搜索单个美国邮政编码 ID

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "targeting_tag_list": [
            {
                "geo": {
                    "description": "postcode",
                    "parent_id": "4292188",
                    "geo_type": "ZIP_CODE",
                    "region_code": "US",
                    "geo_id": "8840000440601"
                },
                "keyword": "40601",
                "name": "40601",
                "targeting_type": "GEO",
                "status_info": {
                    "status": "ENABLED",
                    "reason": null
                }
            }
        ],
        "parent_tags": [
            {
                "status_info": {
                    "status": "ENABLED",
                    "reason": null
                },
                "geo": {
                    "description": "State",
                    "parent_id": "6252001",
                    "geo_type": "PROVINCE",
                    "region_code": "US",
                    "geo_id": "6254925"
                },
                "targeting_type": "GEO",
                "name": "Kentucky"
            },
            {
                "status_info": {
                    "status": "ENABLED",
                    "reason": null
                },
                "geo": {
                    "description": "County",
                    "parent_id": "6254925",
                    "geo_type": "CITY",
                    "region_code": "US",
                    "geo_id": "4292202"
                },
                "targeting_type": "GEO",
                "name": "Franklin County"
            },
            {
                "status_info": {
                    "status": "ENABLED",
                    "reason": null
                },
                "geo": {
                    "description": "City",
                    "parent_id": "4292202",
                    "geo_type": "DISTRICT",
                    "region_code": "US",
                    "geo_id": "4292188"
                },
                "targeting_type": "GEO",
                "name": "Frankfort"
            },
            {
                "status_info": {
                    "status": "ENABLED",
                    "reason": null
                },
                "geo": {
                    "description": "state",
                    "parent_id": "0",
                    "geo_type": "COUNTRY",
                    "region_code": "US",
                    "geo_id": "6252001"
                },
                "targeting_type": "GEO",
                "name": "United States"
            }
        ]
    }
}
(/code)

批量搜索巴西邮政编码 ID

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "parent_tags": [
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "isp": null,
                "name": "Parana",
                "geo": {
                    "geo_type": "PROVINCE",
                    "region_code": "BR",
                    "geo_id": "3455077",
                    "description": "state",
                    "parent_id": "3469034"
                },
                "targeting_type": "GEO"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "isp": null,
                "name": "Sao Paulo",
                "geo": {
                    "geo_type": "PROVINCE",
                    "region_code": "BR",
                    "geo_id": "3448433",
                    "description": "state",
                    "parent_id": "3469034"
                },
                "targeting_type": "GEO"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "isp": null,
                "name": "Brazil",
                "geo": {
                    "geo_type": "COUNTRY",
                    "region_code": "BR",
                    "geo_id": "3469034",
                    "description": "Country",
                    "parent_id": "0"
                },
                "targeting_type": "GEO"
            }
        ],
        "targeting_tag_list": [
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "isp": null,
                "name": "81480",
                "geo": {
                    "geo_type": "ZIP_CODE",
                    "region_code": "BR",
                    "geo_id": "8052000011871",
                    "description": "postcode",
                    "parent_id": "3455077"
                },
                "targeting_type": "GEO",
                "keyword": "81480"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "isp": null,
                "name": "18072",
                "geo": {
                    "geo_type": "ZIP_CODE",
                    "region_code": "BR",
                    "geo_id": "8052000002545",
                    "description": "postcode",
                    "parent_id": "3448433"
                },
                "targeting_type": "GEO",
                "keyword": "18072"
            }
        ]
    }
}
(/code)

批量搜索地域ID

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "targeting_tag_list": [
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "name": "Kentucky",
                "geo": {
                    "geo_type": "PROVINCE",
                    "description": "State",
                    "parent_id": "6252001",
                    "geo_id": "6254925",
                    "region_code": "US"
                },
                "keyword": "Kentucky",
                "targeting_type": "GEO"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "name": "Virginia Beach",
                "geo": {
                    "geo_type": "DISTRICT",
                    "description": "City",
                    "parent_id": "4791271",
                    "geo_id": "4791259",
                    "region_code": "US"
                },
                "keyword": "Virginia",
                "targeting_type": "GEO"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "name": "Virginia Beach",
                "geo": {
                    "geo_type": "CITY",
                    "description": "County",
                    "parent_id": "6254928",
                    "geo_id": "4791271",
                    "region_code": "US"
                },
                "keyword": "Virginia",
                "targeting_type": "GEO"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "name": "West Virginia",
                "geo": {
                    "geo_type": "PROVINCE",
                    "description": "State",
                    "parent_id": "6252001",
                    "geo_id": "4826850",
                    "region_code": "US"
                },
                "keyword": "Virginia",
                "targeting_type": "GEO"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "name": "Virginia",
                "geo": {
                    "geo_type": "PROVINCE",
                    "description": "State",
                    "parent_id": "6252001",
                    "geo_id": "6254928",
                    "region_code": "US"
                },
                "keyword": "Virginia",
                "targeting_type": "GEO"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "name": "Virginia",
                "geo": {
                    "geo_type": "DISTRICT",
                    "description": "City",
                    "parent_id": "5068853",
                    "geo_id": "5081185",
                    "region_code": "US"
                },
                "keyword": "Virginia",
                "targeting_type": "GEO"
            }
        ],
        "parent_tags": [
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "geo": {
                    "geo_type": "PROVINCE",
                    "description": "State",
                    "parent_id": "6252001",
                    "geo_id": "5073708",
                    "region_code": "US"
                },
                "targeting_type": "GEO",
                "name": "Nebraska"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "geo": {
                    "geo_type": "CITY",
                    "description": "County",
                    "parent_id": "5073708",
                    "geo_id": "5068853",
                    "region_code": "US"
                },
                "targeting_type": "GEO",
                "name": "Gage County"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "geo": {
                    "geo_type": "COUNTRY",
                    "description": "Country",
                    "parent_id": "0",
                    "geo_id": "6252001",
                    "region_code": "US"
                },
                "targeting_type": "GEO",
                "name": "United States"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "geo": {
                    "geo_type": "PROVINCE",
                    "description": "State",
                    "parent_id": "6252001",
                    "geo_id": "6254928",
                    "region_code": "US"
                },
                "targeting_type": "GEO",
                "name": "Virginia"
            },
            {
                "status_info": {
                    "reason": null,
                    "status": "ENABLED"
                },
                "geo": {
                    "geo_type": "CITY",
                    "description": "County",
                    "parent_id": "6254928",
                    "geo_id": "4791271",
                    "region_code": "US"
                },
                "targeting_type": "GEO",
                "name": "Virginia Beach"
            }
        ]
    }
}
(/code)
← 搜索其他兴趣分类搜索定向话题标签 →

内容来源：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 每日平台更新简报 →