← 返回目录
📁 API Reference › Accounts › Insights

获取 TikTok 账号主页数据

您可以使用本接口获取有关 TikTok 账号粉丝群体和主页互动的详细分析和洞察。

注意
为确保合规使用账号 API,自 2026 年 3 月 20 日 00:00 (GMT+0) 起,开发者在提交新应用或申请新增“TikTok 账号”权限之前,必须填写账号 API 权限申请表单。请仔细按照说明操作,并提供清晰、准确的信息,以便顺利推进申请审核流程。如需详细了解账号 API 用例,参见账号 API 文档。

注意 - 部分主页层级指标有24-48小时的延迟。本接口数据延迟可查看返回参数表中的字段描述,或查看账号洞察数据延迟-数据延迟参照表。 - 您可通过/business/get/接口获取的数据受对应的 TikTok Analytics 数据影响。TikTok Analytics 数据可在 TikTok 应用或https://www.tiktok.com/analytics查看。若对应指标数据在 TikTok Analytics 不存在,您将无法通过获取相应数据。若想获取洞察及 Analytics 数据, TikTok 账号所有者需首先发布至少一个视频,随后点击手机端 TikTok App 的 Analytics 界面的 "Turn On" (启用)按钮。若想了解详情,请查看这里。 - 您通过/business/get/接口的 video_views 字段获取的视频播放次数为总播放次数,即自然流量产生的视频播放次数和付费流量产生的视频播放次数之和。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。

|变化内容 {33%}|v1.2 {33%}|v1.3 {33%}|
|---|---|---|
|接口路径|/v1.2/business/get/|/v1.3/business/get/|
|方法|POST|GET|
|新增返回参数|/|`is_business_account`<br>`bio_description`<br>`profile_deep_link`<br>`is_verified`<br>`following_count`<br>`total_likes`<br>`videos_count`<br>`unique_video_views`<br>`phone_number_clicks`<br>`lead_submissions`<br>`app_download_clicks`<br>`bio_link_clicks`<br>`email_clicks`<br>`address_clicks`<br>`daily_total_followers`<br>`daily_new_followers`<br>`daily_lost_followers`<br>`audience_ages`<br>`audience_cities`<br>`engaged_audience`|

请求

地址 https://business-api.tiktok.com/open_api/v1.3/business/get/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 创作者授权的访问令牌。<br>若想获取访问令牌,需使用 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/obtain-a-short-term-access-token/v1.3) 接口。|

参数

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

|字段{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`字段值传给本字段。|
| start_date | string | 查询起始日期(闭区间)。格式如下:2021-06-01。日期基于UTC 时区。<br><br>若不进行设置,`start_date` 将为[当前日期- 7 天]。<br><br>支持的最长回溯期为 60 天。 |
| end_date | string | 查询结束日期(闭区间)。格式如下:2021-06-01。日期基于UTC 时区。 <br><br>若不进行设置,`end_date`将为 [当前日期 - 1 天]。|
| fields | string[] | 请求字段。若不进行设置,仅返回<strong>默认</strong>字段。<br><strong>默认值</strong>:`&#91;"display_name", "profile_image"&#93;`。 <br><br>若想返回指定的字段,需要有对应的字段权限。您可根据返回结构中每个字段对应的<strong>“所需权限”</strong>列,查看所需的权限。<br>若想确认您已具备对应的权限范围,您可查看 [/tt_user/token_info/get/](https://ads.tiktok.com/marketing_api/docs?id=1765927978092545)接口返回的权限范围。若您还未获得所需的权限,则需要遵循[授权](https://ads.tiktok.com/marketing_api/docs?id=1738083939371009)中列出的步骤,使 TikTok 账户所有者授予您的 App 对应的权限。 <br><br><strong>示例</strong>:`&#91;"display_name", "profile_image"&#93;`。<br><br><strong>支持字段</strong>:<ul><li>`is_business_account`:该 TikTok 账户是否为 TikTok 企业号。欲获取本指标的数据,需先从 TikTok 账户所有者处获取权限范围"user.account.type"。<br><p><span style="color:darkred"><b>注意</b></span>:欲确认是否已经获取了"user.account.type"的权限范围,您可以查看[/tt_user/token_info/get/](https://ads.tiktok.com/marketing_api/docs?id=1765927978092545)返回的`scope`。若您还未获取该权限,则需遵循[授权](https://ads.tiktok.com/marketing_api/docs?id=1738083939371009)中列出的步骤,使 TikTok 账户所有者重新对您的App进行授权,授予您该权限。 </li> <li>`profile_image`: TikTok 账号主页头像的 URL。</li> <li>`username`:TikTok 账户的用户名。</li><li>`profile_deep_link`:TikTok 账号主页链接。</li><li> `display_name` : TikTok 账号的显示名称(昵称)。</li><li>`bio_description`:TikTok 账号的个人简介。</li><li>`is_verified`:TikTok 账号是否带有认证徽章(蓝 V 认证),从而表明账户所有者的真实性已经过核验。</li><li>`following_count`:TikTok 账号关注的账号数。 </li><li>`followers_count`: TikTok 账号粉丝数。<br><p><span style="color:darkred"><b>注意</b></span>:若您在 `fields` 的值中包含 `followers_count`,`followers_count`将同时作为总指标和每日指标返回。</li><li>`total_likes`:总点赞数。用户对已发布视频的总点赞次数。</li><li>`videos_count`:TikTok 账号发布的公开视频总数。 </li><li>`video_views`: 每日观看次数。您的视频的每日观看次数。<br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>此指标当视频回放时长大于 0,且回放为一次曝光中的首次回放时也计数。</li><li>若用户刷过广告后又回刷广告,将视作两次曝光。第二次曝光也会计入播放次数。 </li></ul></li><li>`unique_video_views`:每日触达的观众。每日至少观看过一次已发布内容的用户。</li><li>`profile_views`:每日个人主页访问量。每日用户查看您的个人主页的次数。</li><li>`likes`:每日点赞数。每日用户对已发布视频的点赞次数。</li><li>`comments`:每日评论数。每日用户对已发布视频的评论次数。</li><li>`shares`:每日分享次数。每日用户对已发布视频的分享次数。</li><li> `phone_number_clicks`:每日手机号码点击数。在选定日期范围内收集的每日手机号码链接的总点击数。</li><li>`lead_submissions`:每日潜在客户提交次数。在选定日期范围内收集的从您的消费者收集的每日潜在客户总数(如报价、新闻资讯订阅等)。</li><li>`app_download_clicks`:每日应用下载链接点击数。在选定日期范围内收集的每日应用下载链接的总点击数。</li><li>`bio_link_clicks`:每日个人简介链接点击数。在选定日期范围内收集的每日个人简介链接的总点击数。</li><li> `email_clicks`:每日邮箱点击数。在选定日期范围内收集的每日主页邮箱按钮的总点击数。</li><li>`address_clicks`:每日地址点击数。在选定日期范围内收集的每日主页地址按钮的总点击数。</li><li>`daily_total_followers`:每日净增长。表示在一定时段内每日关注您账号的用户数。</li><li> `daily_new_followers`:每日新粉丝数。表示在一定时段内每日获得的新粉丝总数。 </li><li> `daily_lost_followers`:每日掉粉数。表示在一定时段内每日失去的粉丝总数。 </li><li>`audience_activity`:每小时粉丝活动。表示您的粉丝一天中在 TikTok 上活跃的时段。<ul><li> 仅为粉丝数至少为 100 的账号返回本指标数据。</li></ul></li><li>`engaged_audience`:每日互动的观众。表示每日与您发布的至少一项内容有过互动(点赞、评论、分享)的用户。</li><li>`audience_ages`:粉丝年龄。按年龄列出粉丝的分布情况。该人口统计数据基于许多因素,包括用户在其个人主页中提供的信息。<ul><li> 仅为粉丝数至少为 100 的账号返回本指标数据。</li></ul></li><li>`audience_genders`: 粉丝性别。按性别列出粉丝的分布情况。该人口统计数据基于许多因素,包括用户在其个人主页中提供的信息。<ul><li> 仅为粉丝数至少为 100 的账号返回本指标数据。</li></ul></li><li>`audience_countries`:粉丝热门国家/地区。按粉丝的位置(国家/地区)列出粉丝的分布情况。该人口统计数据基于许多因素,包括用户在其个人主页中提供的信息。<ul><li> 仅为粉丝数至少为 100 的账号返回本指标数据。</li></ul></li><li>`audience_cities`:粉丝热门城市。粉丝所在城市分布。该人口统计数据基于许多因素,包括用户在其个人主页中提供的信息。<ul><li> 仅为粉丝数至少为 100 的账号返回本指标数据。</li></ul></li></ul>|

示例

(code curl http)
curl --location -g --request GET 'https://business-api.tiktok.com/open_api/v1.3/business/get/?business_id=b3d2f73d-4b8c-47fb-85c3-cd571287754b&fields=["username","display_name","shares","comments", "video_views", "audience_countries"]&start_date=2021-07-28&end_date=2021-08-01' \
--header 'Access-Token: 1234a16d2e08c3f17d1984a1be07d00406p3LIAF7vEpxliox8GRpCINv70x'
(/code)

返回

Header

这些 Header 对于问题报告和排查非常重要,需要记录。下表列出了部分响应标头。

|字段 {20%}|类型 {20%}|描述{60%}|
|---|---|---|
|日期|string|收到返回结果时的日期和时间 (GMT)。<br><br>**示例**:Fri, 13 Aug 2021 08:04:42 GMT|
|X-Tt-Logid|string|API 请求的唯一识别 ID。|

Body

|字段{25%}|类型{15%}|描述{40%}|所需权限{15%}|
|---|---|---|---|
| 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 | 返回数据。 ||
#| is_business_account| boolean | 该 TikTok 账户 (`business_id`) 是否为 TikTok 企业号。<br>枚举值: <ul><li> `true`:该 TikTok 账户是 TikTok 企业号。</li><li> `false`:该 TikTok 账户是 TikTok 个人账号。</li></ul>| `user.account.type`|
#|profile_image | string |  TikTok 账号主页头像的临时URL。过期日期和时间以 Epoch/Unix 时间格式包含在`x-expires`查询参数中,以秒为单位。<br><br><strong>示例</strong>:https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/75dec21d63500917fb6ec8bc59415156~c5_300x300.jpeg?x-expires=1614099600&x-signature=PmK%2BWs3LzSzRL2tYs%2FZx7EjG3Gk%3D<br><br><strong>更新时间</strong>:实时 | `user.info.basic`|
#|username | string |  TikTok 账号的用户名。<br><br><strong>示例</strong>:la_flama_blanca <br><br><strong>更新时间</strong>:实时| `user.info.username`|
#| profile_deep_link | string | TikTok 账号主页链接。 <br> <br><strong>示例</strong>:https://vm.tiktok.com/ABcdEfghi/  <br> <br><strong>更新时间</strong>:实时 |`user.info.profile` |
#|display_name | string |  TikTok 账号的显示名称(昵称)。<br><br><strong>示例</strong>:La Flama Blanca <br><br><strong>更新时间</strong>:实时 | `user.info.basic`|
#| bio_description | string |  TikTok 账号的个人简介。 <br> <br><strong>更新时间</strong>:实时 <br><br><p><span style="color:darkred"><b>注意</b></span>:若您从未设置过 TikTok 账号的个人简介,本字段将返回空字符串(`""`)。| `user.info.profile` |
#| is_verified | boolean | TikTok 账号是否带有认证徽章(蓝 V 认证),从而表明账户所有者的真实性已经过核验。<br> <br>支持的值:`true`,`false`。<br> <br><strong>示例</strong>:`true` <br> <br><strong>更新时间</strong>:实时  | `user.info.profile` |
#| following_count | integer | TikTok 账号关注的账号总数。 <br> <br><strong>示例</strong>:2  <br> <br><strong>更新时间</strong>:实时 | `user.info.stats` |
#|followers_count | integer |  TikTok 账号的总粉丝数。<br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:实时 |`user.info.stats`|
#| total_likes | integer | 总点赞数。<br> 用户对已发布视频的总点赞次数。 <br> <br><strong>示例</strong>:6 <br> <br><strong>更新时间</strong>:实时 | `user.info.stats` |
#| videos_count | integer |  TikTok 账号发布的公开视频总数。<br> <br><strong>示例</strong>:6 <br> <br><strong>更新时间</strong>:实时 | `user.info.stats` |
#|metrics | object[] | 所有请求的每日数据指标。<br><br><p><span style="color:darkred"><b>注意</b></span>:仅返回 TikTok 账号创建后的数据指标。数据指标可能延迟最长 24-48 小时。 ||
##|date | string | 这些每日数据指标的对应日期,格式为YYYY-MM-DD,时区为UTC。 <br><br><strong>示例</strong>:2021-08-12  <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)|N/A|
##|video_views | integer |  每日观看次数。<br>您的视频的每日观看次数。<br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>此指标当视频回放时长大于0,且回放为一次曝光中的首次回放时也计数。</li><li>若用户刷过广告后又回刷广告,将视作两次曝光。第二次曝光也会计入播放次数。</li></ul><br><br><strong>示例</strong>:123   <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间) | `user.insights`|
##|unique_video_views | integer |每日触达的观众。<br>每日至少观看过一次已发布内容的用户。 <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)    | `user.insights`|
##|profile_views | integer | 每日个人主页访问量。<br>每日用户查看您的个人主页的次数。 <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)  <br><br><p><span style="color:darkred"><b>注意</b></span>:仅为[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)返回本指标数据。  | `user.insights`|
##|likes | integer |  每日点赞数。<br>每日用户对已发布视频的点赞次数。<br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间) <br><br><p><span style="color:darkred"><b>注意</b></span>:此字段显示的点赞数不会减去取消点赞数(即后来被移除或撤回的点赞)。这个数值可能与<b>企业套件</b> > <b>数据分析</b>页面上企业号显示的点赞数有所不同。<br>例如,若一条帖子收到 30 个点赞和 10 个取消点赞:<ul><li>此字段将显示点赞数为 30。</li><li>企业号的数据分析页面将显示点赞数为 20(30个点赞 - 10个取消点赞)。</li></ul>| `user.insights`|
##|comments| integer | 每日评论数。<br>每日用户对已发布视频的评论次数。<br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)    | `user.insights`|
##|shares | integer |  每日分享次数。<br>每日用户对已发布视频的分享次数。<br><br><strong>示例</strong>:123  <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)    | `user.insights`|
##|phone_number_clicks | integer | 每日手机号码点击数。<br>在选定日期范围内收集的每日手机号码链接的总点击数。 <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)  <br><br><p><span style="color:darkred"><b>注意</b></span>:仅为[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)返回本指标数据。  | `user.insights`|
##| lead_submissions | integer | 每日潜在客户提交次数。<br>在选定日期范围内从您的消费者收集的每日潜在客户总数(如报价、新闻资讯订阅等)。 <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)  <br><br><p><span style="color:darkred"><b>注意</b></span>:仅为[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)返回本指标数据。  | `user.insights`|
##|app_download_clicks | integer | 每日应用下载链接点击数。<br>在选定日期范围内收集的每日应用下载链接的总点击数。<br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)  <br><br><p><span style="color:darkred"><b>注意</b></span>:仅为[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)返回本指标数据。  | `user.insights`|
##|bio_link_clicks | integer | 每日个人简介链接点击数。<br>在选定日期范围内收集的每日个人简介链接的总点击数。 <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)  <br><br><p><span style="color:darkred"><b>注意</b></span>:仅为[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)返回本指标数据。  | `user.insights`|
##|email_clicks | integer | 每日邮箱点击数。<br>在选定日期范围内收集的每日主页邮箱按钮的总点击数。 <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)  <br><br><p><span style="color:darkred"><b>注意</b></span>:仅为[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)返回本指标数据。  | `user.insights`|
##|address_clicks | integer | 每日地址点击数。<br>在选定日期范围内收集的每日主页地址按钮的总点击数。 <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)  <br><br><p><span style="color:darkred"><b>注意</b></span>:仅为[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)返回本指标数据。  | `user.insights`|
##| daily_total_followers | integer | 每日净增长。<br>表示在一定时段内每日关注您账号的用户数。 <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间) | `user.insights`|
##|  daily_new_followers | integer |每日新粉丝数。<br>表示在一定时段内每日获得的新粉丝总数。  <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间) | `user.insights`|
##|daily_lost_followers | integer |  每日掉粉数。<br>表示在一定时段内每日失去的粉丝总数。 <br><br><br><strong>示例</strong>:123 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间) | `user.insights`|
##|followers_count | integer |  TikTok 账号在某一日期的粉丝总数。<br><br><strong>示例</strong>:123<br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)   | `user.insights`|
##|audience_activity | object[] | 每小时粉丝活动。 <br>表示您的粉丝一天中在 TikTok 上活跃的时段。 <br><br><strong>示例</strong>:`[&#123;"hour": "0", "count": 12&#125;, &#123;"hour": "1", "count": 18&#125;, &#123;"hour": "2", "count": 23&#125;, &#123;"hour": "3", "count": 28&#125;, ...]`  <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)<br><br><p><span style="color:darkred"><b>注意</b></span>:仅为粉丝数至少为 100 的 TikTok 账号返回本指标数据。 | `user.insights`|
###|hour | string | 一天中的某一小时。 ||
###|count | integer | 某一小时的活跃粉丝数。||
##|engaged_audience | integer | 每日互动的观众 。<br>表示每日与您发布的至少一项内容有过互动(点赞、评论、分享)的用户。 | `user.insights`|
#| audience_ages | object[] | 粉丝年龄。<br>按年龄列出粉丝的分布情况。该人口统计数据基于许多因素,包括用户在其个人主页中提供的信息。 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间) <br><br><p><span style="color:darkred"><b>注意</b></span>:仅为粉丝数至少为 100 的 TikTok 账号返回本指标数据。|   `user.insights`|
##|age | string | 年龄区间。<br><br>枚举值:`18-24`,`25-34`,`35-44`,`45-54`,`55+`。||
##|percentage | float | 某一年龄区间关联的粉丝所占的百分比。 ||
#|audience_genders | object[] |  粉丝性别。<br>按性别列出粉丝的分布情况。该人口统计数据基于许多因素,包括用户在其个人主页中提供的信息。 <br><br><strong>示例</strong>: `[&#123;gender: "Female", percentage: 0.7554470336505679&#125;, &#123;gender: "Male", percentage: 0.24455296634943213&#125;, ...]`    <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)<br><br><p><span style="color:darkred"><b>注意</b></span>:仅为粉丝数至少为 100 的 TikTok 账号返回本指标数据。  | `user.insights`|
##|gender | string | 性别。<br><br>枚举值:`Female`,`Male`,`Other` 。||
##|percentage | float | 某一性别关联的粉丝百分比。 ||
#|audience_countries | object[] |  粉丝热门国家/地区。<br>按粉丝的位置(国家/地区)列出粉丝的分布情况。该人口统计数据基于许多因素,包括用户在其个人主页中提供的信息。<br><br><strong>示例</strong>: `[&#123;country: "US", percentage: 0.7554470336505679&#125;, &#123;country: "UK", percentage: 0.24455296634943213&#125;, ...]`  <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间)<br><br><p><span style="color:darkred"><b>注意</b></span>:仅为粉丝数至少为 100 的 TikTok 账号返回本指标数据。|   `user.insights`|
##|country | string | [ISO 3166-1 两位字母](https://zh.wikipedia.org/wiki/ISO_3166-1%E4%BA%8C%E4%BD%8D%E5%AD%97%E6%AF%8D%E4%BB%A3%E7%A0%81)国家/ 地区代码。||
##|percentage | float | 从某一国家/地区注册的粉丝百分比。 ||
#|audience_cities | object[] | 粉丝热门城市。<br>粉丝所在城市分布。该人口统计数据基于许多因素,包括用户在其个人主页中提供的信息。 <br><br><strong>更新时间</strong>:T+ 24-48 小时(UTC 时间) <br><br><p><span style="color:darkred"><b>注意</b></span>:仅为粉丝数至少为 100 的 TikTok 账号返回本指标数据。|   `user.insights`|
##|city_name | string | 城市名称。||
##|percentage | float | 某一城市关联的粉丝百分比。 ||

示例

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "202108030711080102450310564DA3B2EB",
    "data": {
        "profile_image": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/188d468fc1de3f328250ea0c96e98f8b~c5_100x100.webp?x-expires=1628060400&x-signature=BnPoX8rWsYZZ%2BtyzCoWanxYdRyg%3D",
        "username": "la_flama_blanca",
        "display_name": "Display Name",
        "followers_count": 1124,
        "audience_countries": [
            {
                "percentage": 0.1797,
                "country": "MY"
            },
            {
                "percentage": 0.5996,
                "country": "TW"
            },
            {
                "percentage": 0.0629,
                "country": "VN"
            }
        ],
        "audience_genders": [
            {
                "percentage": 0.6031,
                "gender": "Female"
            },
            {
                "percentage": 0.1685,
                "gender": "Male"
            },
            {
                "percentage": 0.2283,
                "gender": "Other"
            }
        ],
        "metrics": [
            {
                "date": "2021-07-30",
                "followers_count": 4,
                "video_views": 1126,
                "comments": 4,
                "shares": 0,
                "likes": 26
            },
            {
                "date": "2021-07-31",
                "followers_count": 6,
                "video_views": 312,
                "comments": 0,
                "shares": 0,
                "likes": 15
            },
            {
                "date": "2021-08-01",
                "followers_count": 8,
                "video_views": 283,
                "comments": 0,
                "shares": 0,
                "likes": 19
            }
        ]
    }
}
(/code)

字段所需权限更改日志

某些字段所需的权限已进行了更新,请查看下表了解更新详情。

为保证流畅的API体验,我们建议您尽快遵循授权中列出的步骤,使 TikTok 账户所有者授予您的 App 更新后的字段权限。

若想确认您已具备对应的权限范围,您可查看/tt_user/token_info/get/接口返回的权限范围。

字段 旧有权限 当前权限 权限更新时间
is_business_account user.account.type user.account.type -
username user.info.basic
user.info.username 2023年6月
display_name user.info.basic
-
profile_image -
followers_count user.info.stats 2023年6月
audience_countries user.insights user.insights
-
audience_genders -
metrics.followers_count -
metrics.profile_views -
metrics.video_views -
metrics.likes -
metrics.comments -
metrics.shares -
metrics.audience_activity -
metrics.date N/A N/A -

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →