获取已授权的 TTO 达人表现数据
你可以使用本接口获取已加入 TikTok One（TTO）的 TikTok 达人的详情和表现数据。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/tto/creator/authorized/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|field|由 TikTok 创作者授权的访问令牌。<br>使用 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-获取创作者访问令牌) 或 [/tt_user/oauth2/refresh_token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-刷新创作者访问令牌) 接口获取或刷新访问令牌。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
|creator_id {必填}|string|TikTok 账号的应用唯一识别 ID。<br><br>将 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-获取创作者访问令牌) 或 [/tt_user/oauth2/refresh_token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-刷新创作者访问令牌) 接口返回的 `open_id` 字段值传入此字段。|
|fields|string[]|请求的字段。<br><br>如果未设置此字段，将返回默认字段（`profile_image` 和 `display_name`）。|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tto/creator/authorized/?creator_id={{creator_id}}&fields=["handle_name","display_name","profile_image","bio","followers_count","following_count","videos_count","likes_count","creator_rate","country_code","content_labels","industry_labels","audience_countries","audience_genders","audience_ages","audience_devices","audience_usages"]' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{30%}|Type{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述，可见 [附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息可见 [附录 - 返回码](1737172488964097.html)。|
|request_id |string|请求的日志 ID，唯一标识该请求。|
|data|object|返回数据。|
#|profile_image|string|达人头像的临时 URL。<br>URL 中的 `x-expires` 参数后包含过期时间，格式为以秒为单位的 Epoch/Unix 时间戳。<br><br>有效期：约七天。|
#|handle_name|string|达人的唯一账号名称。|
#|display_name|string|达人的显示名称。|
#|bio|string|达人的个人简介。|
#|following_count|number|达人关注的账号数量。|
#|followers_count|number|达人的粉丝数量。|
#|likes_count|number|总点赞数。<br>达人发布的视频被点赞的总次数。|
#|videos_count|number|达人发布的公开视频总数。|
#|creator_rate|object|达人起始价格。|
##|rate|number|起始价格的金额。|
##|currency|string|起始价格的币种，采用 [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 代码格式。<br><br>示例：`EUR`。|
#|country_code|string|达人所在国家或地区的代码，采用 [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) 格式。<br><br>示例：`US`。|
#|content_labels|object[]|达人行业标签列表。<br>达人行业标签基于其制作的商业内容（包括广告创意和其 TikTok 账号上的品牌内容），代表其在特定行业的商业经验。|
##|label_id|number|达人行业标签的 ID。<br><br>示例：11015001。|
##|label_name|string|达人行业标签名称。<br><br>示例：`Tech Products & Tests`。|
#|industry_labels|object[]|视频内容标签列表。<br>内容标签基于达人 TikTok 账号的主要内容方向，代表达人的原生内容方向。|
##|label_id|number|内容标签的 ID。<br><br>示例：23000000000。|
##|label_name|string|内容标签名称。<br><br>示例：`News & Entertainment`。|
#|audience_countries|object[]|受众规模最大的三个国家或地区。|
##|country|string|国家或地区代码，采用 [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) 格式。<br><br>示例：`US`。|
##|percentage|number|百分比。|
#|audience_genders|object[]|受众性别信息。|
##|gender|string|性别。<br><br>枚举值：`Female`、`Male`。|
##|percentage|number|百分比。|
#|audience_ages|object[]|受众年龄分布。|
##|age|string|年龄组。<br><br>枚举值：`25-34`、`35-44`、`55+`、`Other`。|
##|percentage|number|百分比。|
#|audience_devices|object[]|受众设备信息。|
##|device|string|设备。<br><br>枚举值：<ul><li>`APPLE`：Apple</li><li>`SAMSUNG`：Samsung</li><li>`XIAOMI`：Xiaomi</li><li>`OPPO`：Oppo</li><li>`MOTOROLA`：Motorola</li><li>`OTHER`：其它</li></ul>|
##|percentage|number|百分比。|
#|audience_usages|object[]|受众的 TikTok 使用情况。|
##|usage|string|是否频繁使用 TikTok。<br><br>枚举值：<ul><li>`active`：是。过去 30 天内登录过 TikTok 应用。</li><li>`inactive`：否。</li></ul>|
##|percentage|number|百分比。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"audience_ages": [
{
"age": "25-34",
"percentage": 0.375
},
{
"age": "35-44",
"percentage": 0.375
},
{
"age": "Other",
"percentage": 0.125
},
{
"age": "55+",
"percentage": 0.125
}
],
"audience_countries": [
{
"country": "US",
"percentage": 0.5
},
{
"country": "JP",
"percentage": 0.375
},
{
"country": "MY",
"percentage": 0.125
}
],
"audience_devices": [
{
"device": "APPLE",
"percentage": 0.7777777777777778
},
{
"device": "SAMSUNG",
"percentage": 0.1111111111111111
},
{
"device": "XIAOMI",
"percentage": 0.1111111111111111
},
{
"device": "Other",
"percentage": 0
}
],
"audience_genders": [
{
"gender": "Male",
"percentage": 0.625
},
{
"gender": "Female",
"percentage": 0.375
}
],
"audience_usages": [
{
"percentage": 0.875,
"usage": "active"
},
{
"percentage": 0.125,
"usage": "inactive"
}
],
"bio": "{{bio}}",
"content_labels": [
{
"label_id": 11015001,
"label_name": "Tech Products & Tests"
}
],
"country_code": "US",
"creator_rate": {
"currency": "USD",
"rate": 1000
},
"display_name": "{{display_name}}",
"followers_count": 8,
"following_count": 0,
"handle_name": "{{handle_name}}",
"industry_labels": [
{
"label_id": 23000000000,
"label_name": "News & Entertainment"
},
{
"label_id": 24000000000,
"label_name": "Business Services"
},
{
"label_id": 29000000000,
"label_name": "Health"
}
],
"likes_count": 0,
"profile_image": "{{profile_image}}",
"videos_count": 3
}
}
(/code)