获取 TTO 的公开账号表现数据
你可以使用本接口获取 TikTok One (TTO) Creator Marketplace 中达人的主页基本信息。
TCM 与 TTO Creator Marketplace接口对比
以下表格概括了 TikTok Creator Marketplace（TCM）与 TTO Creator Marketplace 接口的变化。
| 变化内容 {24%}| TCM 接口{36%} | TTO Creator Marketplace接口{40%} |
|---|---|---|
| 接口路径 | /v1.3/tcm/creator/public/ | /v1.3/tto/tcm/creator/public/ |
| 相同请求参数 | `handle_name` | `handle_name` |
| 废弃请求参数 | N/A | `tcm_account_id` |
| 新增请求参数 | N/A | `tto_tcm_account_id` |
| 相同返回参数 | `profile_image`<br>`handle_name`<br>`display_name`<br>`followers_count`<br>`likes_count`<br>`videos_count`<br>`creator_id`<br>`bio` | `profile_image`<br>`handle_name`<br>`display_name`<br>`followers_count`<br>`likes_count`<br>`videos_count`<br>`creator_id`<br>`bio` |
| 新增返回参数 | N/A | `following_count`<br>`median_views` <br>`engagement_rate`<br>`creator_price`<br> `currency`<br>`industry_labels` <br>`industry_labels.label_id`<br>`industry_labels.label_name`<br>`content_labels`<br>`content_labels.label_id`<br>`content_labels.label_name` |
请求
地址 https://business-api.tiktok.com/open_api/v1.3/tto/tcm/creator/public/
方法 GET
Header
|字段{30%}|类型{15%}|描述{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|TTO Creator Marketplace 账户的 ID。<br><br>要获取您通过访问令牌 `Access-Token` 可访问的账户 ID，可使用接口 [/tto/oauth2/tcm/](1815693478150146.html)。|
|handle_name {必填}|string|您想要搜索的 TTO 创作者市场创作者的用户名。<br><br>支持精确匹配。<br><br><span style="color:darkred"><b>注意</b></span>：如果您指定的账号用户名尚未加入 TTO Creator Marketplace，将会出现报错。|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tto/tcm/creator/public/?tto_tcm_account_id={{tto_tcm_account_id}}&handle_name={{handle_name}}' \
--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|返回数据。|
#|handle_name|string|达人的唯一用户名。|
#|display_name|string|创作者的显示名称。|
#|profile_image|string|创作者头像的临时 URL。<br><br>有效期：约七天。<br><br>URL 中的 `x-expires` 参数后包含过期时间，格式为以秒为单位的 Epoch/Unix 时间戳。<br><br>URL 过期后，您可以调用 [/tto/tcm/creator/public/](1828185358712897.html) 获取新的 URL。|
#|bio|string|创作者的个人简介。<br><br><span style="color:darkred"><b>注意</b></span>：如果简介包含多行，简介中的换行符将在字段值中以 `\n` 表示。|
#|followers_count|number|创作者的粉丝数量。<br><br>示例：100。|
#|following_count|number|创作者关注的账号数量。<br><br>示例：100。|
#|videos_count|number|创作者发布的公开视频数量。<br><br>示例：100。|
#|likes_count|number|创作者公开视频的点赞总数。<br><br>示例：100。|
#|creator_id|string|创作者的唯一 ID。<br><br>示例：`1234567891234567891`。|
#|median_views|number|播放量中位数。<br><br>达人最近视频播放量范围的中间值，按从低到高的顺序排列，展示达人内容的典型视频播放量。|
#|engagement_rate|float|互动率。<br><br>创作者最近 30 个视频中，与内容互动的人数占比。计算方式为评论数、点赞数和分享数之和除以视频观看量。<br><br>示例：0.13669180870056152。|
#|creator_price|number|创作者的起始价格。<br><br>示例：500。|
#|currency|string|起始价格的币种，采用 ISO 4217 格式。<br><br>示例：`USD`。|
#|industry_labels|object[]|达人行业标签列表，可用于获取 TTO 达人排行榜上的品牌内容达人排名。<br><br>创作者行业标签根据其制作的商业内容（包括广告创意和其 TikTok 账号上的品牌内容）分配，代表其在特定行业的商业经验。<br><br>每个 `label_id` 可用于 [/tto/tcm/rank/](1816378813274113.html)，获取该标签下最多 100 名美国排名最高的创作者列表。|
##|label_id|string|创作者行业标签的 ID。<br><br>示例：`20000000000`。|
##|label_name|string|创作者行业标签名称。<br><br>示例：`Apps`。|
#|content_labels|object[]|内容标签列表，可用于获取 TTO 创作者排行榜上的原生内容达人自然内容创作者排名。<br><br>内容标签根据创作者 TikTok 账号的主要内容方向分配，代表创作者的原生内容方向。<br><br>每个 `label_id` 可用于 [/tto/tcm/rank/](1816378813274113.html)，获取该标签下最多 100 名美国排名最高的创作者列表。|
##|label_id|string|内容标签的 ID。<br><br>示例：`11005001007`。|
##|label_name|string|内容标签名称。<br><br>示例：`Shooting Games`。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"bio": "{{bio}}",
"content_labels": [
{
"label_id": "11005001007",
"label_name": "Shooting Games"
}
],
"creator_id": "{{creator_id}}",
"creator_price": 100,
"currency": "USD",
"display_name": "{{display_name}}",
"engagement_rate": 0.08472570776939392,
"followers_count": 4721794,
"following_count": 231,
"handle_name": "{{handle_name}}",
"industry_labels": [
{
"label_id": "20000000000",
"label_name": "Apps"
}
],
"likes_count": 153119665,
"median_views": 426141,
"profile_image": "{{profile_image}}",
"videos_count": 1803
}
}
(/code)