获取可为企业号启用的合法品牌提及话题

您可以使用本接口获取能为企业号启用的合法话题列表。返回结果将包含最多 100 个与该企业号相关的热门话题。

可为企业号启用的合法话题必须满足以下条件： - 至少有 3 个帖子标题使用了该话题，且这些帖子由企业号发布或提及企业号用户名。

你可以使用 /business/mention/hashtag/add/ 接口为企业号启用合法话题。启用后，这些话题将纳入 /business/mention/hashtag/video/list/ 接口返回的结果。

Note
此接口专为具有大量原生提及活动的账号设计。测试账号或新创建的账号可能无法返回有效话题标签，不推荐用于接口测试。为获得准确的测试结果，你需要使用已有原生提及数据的线上账号。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/business/mention/hashtag/verify/list/

方法 GET

Header

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

参数

|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
|business_id {必填}|string|TikTok 企业号的开发者应用唯一识别 ID。<br><br>你可以通过 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1825105003772930#item-link-Obtain%20an%20access%20token) 接口返回的 `open_id` 字段获取 ID。|
| username {必填}  | string | 企业号的用户名。 |

示例

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/business/mention/hashtag/verify/list/?business_id={{business_id}}&username={{username}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。 |
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id |string|请求的日志 ID，唯一标识一个请求。  |
|data |object|返回数据。|
#| hashtag_list | object[] | 可为企业号启用的合法话题列表。|
##| hashtag | string | 可为企业号启用的合法话题。|
##| post_count | number | 近 90 天内，在标题中使用该话题的帖子总数。|
##| like_count | number | 近 90 天内，在标题中使用该话题的帖子获得的总点赞数。|
##| mention_post_rank | number | 该话题在所有可为企业号启用的合法话题中的排名。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "hashtag_list": [
            {
                "create_date": "2025-05-21",
                "hashtag": "{{hashtag}}"
            },
            {
                "create_date": "2025-05-21",
                "hashtag": "{{hashtag}}"
            }
        ]
    }
}
(/code)