获取 TTO 达人排名标签或搜索标签
你可以使用本接口获取与 TikTok One（TTO）达人关联的达人行业标签或视频内容标签。
根据获取的标签类型 (label_type) ，可以将排名标签用于 /tto/tcm/rank/，从而获取该标签下最多 100 名排名最高的美国达人列表，或将搜索标签用于 /tto/tcm/creator/discover/，从而发现更多达人。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/tto/tcm/category/label/
方法 GET
Header
|Field{30%}|Data Type{15%}|Description{55%}|
|---|---|---|
|Access-Token {必填}|string|由 TTO Creator Marketplace 账户授权的访问令牌。 <br>详情参见[从 TTO Creator Marketplace 账户获取授权和访问令牌](https://business-api.tiktok.com/portal/docs/obtain-authorization-and-authentication-from-a-tto-creator-marketplace-account/v1.3)。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
| tto_tcm_account_id {必填} | string | TikTok One Creator Marketplace账户的 ID。<br><br>要获取您通过访问令牌 `Access-Token` 可访问的账户 ID，使用接口 [/tto/oauth2/tcm/](1815693478150146.html)。 |
| label_type {必填} | string | 标签类型。<br><br>枚举值：<ul><li>`RANKING`：排名标签。可用于 [/tto/tcm/rank/](1816378813274113.html) 接口获取达人的排名。</li><li>`SEARCH`：搜索标签。可用于 [/tto/tcm/creator/discover/](1825017307843585.html) 接口发现达人。</li></ul> |
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tto/tcm/category/label/?tto_tcm_account_id={{tto_tcm_account_id}}&label_type=RANKING' \
--header 'Access-Token: {{Access-Token}}'
(/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|返回数据。|
#| industry_labels | object[] | 达人行业标签列表，可用于获取 TTO 达人排行榜上的品牌内容达人排名。<br>达人行业标签基于其制作的商业内容（包括广告创意和其 TikTok 账号上的品牌内容），代表其在特定行业的商业经验。|
##| label_id | string | 达人行业标签的 ID。|
##| label_name | string | 达人行业标签名称。|
#| content_labels | object[] | 视频内容标签列表，可用于获取 TTO 达人排行榜上的原生内容达人排名。<br>视频内容标签基于达人 TikTok 账号的主要内容方向，代表达人的原生内容方向。|
##| label_id | string | 内容标签的 ID。|
##| label_name| string | 内容标签名称。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"content_labels": [
{
"label_id": "11007001",
"label_name": "Fitness"
},
{
"label_id": "11009001",
"label_name": "Love & Romantic Relationships"
},
{
"label_id": "11009002",
"label_name": "Babies"
},
{
"label_id": "11014001",
"label_name": "Automobiles"
},
{
"label_id": "11010004",
"label_name": "Cooking & Recipes"
},
{
"label_id": "11011007",
"label_name": "Jobs & Careers"
},
{
"label_id": "11015001",
"label_name": "Tech Products & Tests"
},
{
"label_id": "11015003",
"label_name": "Business & Finance"
},
{
"label_id": "11001001",
"label_name": "Pet Tips & Care"
},
{
"label_id": "11003001",
"label_name": "Outfits"
},
{
"label_id": "11007004",
"label_name": "Traditional Sports"
},
{
"label_id": "11009003",
"label_name": "Family"
},
{
"label_id": "11013006",
"label_name": "Home & Garden"
},
{
"label_id": "11004003",
"label_name": "Music"
},
{
"label_id": "11004004",
"label_name": "Dance"
},
{
"label_id": "11008001",
"label_name": "Comedy"
},
{
"label_id": "11013005",
"label_name": "Travel"
},
{
"label_id": "11002002",
"label_name": "Beauty Tutorials & Tips"
},
{
"label_id": "11002006",
"label_name": "Hair Design & Care"
},
{
"label_id": "11004001",
"label_name": "Movies & TV"
},
{
"label_id": "11005001",
"label_name": "Video Games"
}
],
"industry_labels": [
{
"label_id": "16000000000",
"label_name": "Appliances"
},
{
"label_id": "18000000000",
"label_name": "Household Products"
},
{
"label_id": "22000000000",
"label_name": "Apparel & Accessories"
},
{
"label_id": "15000000000",
"label_name": "Tech & Electronics"
},
{
"label_id": "14000000000",
"label_name": "Beauty & Personal Care"
},
{
"label_id": "21000000000",
"label_name": "Home Improvement"
},
{
"label_id": "25000000000",
"label_name": "Games"
},
{
"label_id": "28000000000",
"label_name": "Sports & Outdoor"
},
{
"label_id": "11000000000",
"label_name": "Vehicle & Transportation"
}
]
}
}
(/code)