为 TikTok 账号获取推荐话题标签

您可以使用本接口传入关键词，从而为您的TikTok 账号视频获取推荐话题标签列表。

返回的话题标签（name）可在使用/business/video/publish/将视频发布到 TikTok 账号时，用在caption字段中作为视频文案中的一部分。

本接口为1.3版本中的新接口。

请求

地址：https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/

方法：GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 创作者授权的访问令牌。<br>若想获取访问令牌，需使用[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-获取访问令牌)接口。|

参数

请将下列参数作为查询字符串进行传递。

|字段{30%}|类型{15%} |描述{55%}|
|--- |--- |--- |--- |
|business_id {必填}| string | TikTok 账户的应用唯一识别ID。<br>您需将[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-获取访问令牌)接口返回的`open_id`字段值传给本字段。|
|keyword {必填}| string | 要获取对应推荐话题标签的关键词。|
| language| string |关键词语言。推荐话题标签的语言将与指定的关键词语言一致。<br><br><strong>默认值</strong>： `en`（英语）<br><br><strong>枚举值</strong>：<ul><li>`en`：英语</li><li>`ar`：阿拉伯语</li><li>`bn-IN`：孟加拉语</li><li>`ceb-PH`：宿务语</li><li>`cs-CZ`：捷克语</li><li>`de-DE`：德语</li><li>`el-GR`：希腊语</li><li>`es`：西班牙语</li><li>`fi-FI`：芬兰语</li><li>`fil-PH`：菲律宾语</li><li>`fr`：法语</li><li>`he-IL`：希伯来语</li><li>`hi-IN`：印地语</li><li>`hu-HU`：匈牙利语</li><li>`id-ID`：印尼语</li><li>`it-IT`：意大利语</li><li>`ja-JP`：日语</li><li>`jv-ID`：爪哇语</li><li>`km-KH`：柬埔寨语</li><li>`ko-KR`：韩语</li><li>`ms-MY`：马来语</li><li>`my-MM`：缅甸语</li><li>`nl-NL`：芬兰语</li><li>`pl-PL`：波兰语</li><li>`pt-BR`：葡萄牙语</li><li>`ro-RO`：罗马尼亚语</li><li>`ru-RU`：俄语</li><li>`sv-SE`：瑞典语</li><li>`th-TH`：泰语</li><li>`tr-TR`：土耳其语</li><li>`uk-UA`：乌克兰语</li><li>`ur`：乌尔都语</li><li>`vi-VN`：越南语</li><li>`zh-Hans`：简体中文</li><li>`zh-Hant-TW`：繁体中文</li></ul>|

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/?business_id={{business_id}}&keyword=summer&language=en' \
  --header 'Access-Token: {{Access-Token}}'
(/code)

Header

这些header很重要，可用于记录问题报告和故障排查信息。下表列出了部分返回的header。

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| Date | string | 收到返回时的(GMT)日期和时间 。 <br><strong>示例</strong>：Fri, 13 Aug 2021 08:04:42 GMT |
| X-Tt-Logid | string | 接口请求的唯一标识符。|

Body

|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
| request_id | string | 接口请求的唯一标识符。<br><br>请记录此字段，用于所有接口请求。此字段对于问题报告和故障排查十分重要。 |
| code | integer | 返回码。完整返回码列表及描述，可查看[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message| string | 返回信息。更多信息可查看[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
| data | object | 返回数据。|
#|suggestions | object[]| 推荐话题标签列表。共计返回十个推荐话题标签，话题标签先按精确匹配，其次按照浏览量排序。<br><p><span style="color:darkred"><b>注意</b></span>：若针对您传入的关键词无法匹配到推荐话题标签，将在`name`字段返回传入的关键词，且 `view_count`将显示为0。 |
##| name | string | 推荐的话题标签名称。|
##| view_count | integer | 推荐的话题标签对应的浏览量。|

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "app_id": "{{app_id}}",
        "creator_id": "{{creator_id}}",
        "scope": "video.publish,user.info.basic,video.list,user.insights,user.insights.creator,tcm.order.update,comment.list.manage,video.insights,comment.list"
    }
}
(/code)