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

获取 TikTok 账号帖子数据

此接口可用于获取 TikTok 账号所有公开视频、图片或文字帖子的覆盖人数和互动数据。视频帖子包括在账号主页中显示的自然流量视频，以及“仅在广告中显示”的视频帖子（仅用于广告投放的视频帖子，不会在 TikTok 账号主页中显示，但会作为广告公开展示）。

结果将分页显示。你可以使用 max_count 设置每页返回的最大帖子数量。

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

注意
- 部分主页层级的指标会有 24-48 小时的延迟。若想了解数据的延迟情况，可查看返回表格中的描述，或参见账号洞察数据延迟 - 数据延迟参考表。 - 帖子数据将在帖子发布 365 天后停止更新。 - 可通过 /business/video/list/ 接口获取的数据取决于你能否在应用以及 https://www.tiktok.com/analytics 中查看相应的 TikTok Analytics 数据。如果 TikTok Analytics 中缺少相应的指标数据，你将无法获取该数据。 - 如需了解每个指标对应的 TikTok Analytics 平台（TikTok Studio 或业务分析），查看返回结果中每个指标的字段说明。 - 若想查看洞察和分析数据，TikTok 账号所有者需先至少发布一个视频，然后点击 TikTok 手机应用分析页面上的“开启”按钮。如需了解更多信息，参见此处。 - 使用字段 video_views 通过 /business/video/list/ 接口获取的视频播放量数据是一个总指标，涵盖自然流量和付费流量活动。 - 如果 reach、full_video_watched_rate、total_time_watched、average_time_watched、impression_sources 和 audience_countries 字段的数据不可用，通常是因为该视频超过 7 天无活跃行为（播放/点赞/评论/分享）。若想获取这些字段的数据，可以播放/点赞/评论/分享该视频，并在 24-48 小时后重新请求获取数据。 - 如果某个帖子未返回，可能是因为该帖子因违规而被排除，例如侵犯音乐版权。

v1.2 与 v1.3 接口对比

下表概述了 v1.2 接口与 v1.3 接口之间的差异。

|变更 {33%}|v1.2 {33%}|v1.3 {33%}|
|---|---|---|
|接口路径|/v1.2/business/videos/list/|/v1.3/business/video/list/|
|方法|POST|GET|
|新增请求参数|/|`ad_post_only`|
|新增返回参数|/|`favorites`<br>`profile_views`<br>`website_clicks`<br>`phone_number_clicks`<br>`lead_submissions`<br>`app_download_clicks`<br>`email_clicks`<br>`address_clicks`<br>`video_view_retention`<br>`audience_genders`<br>`audience_cities`<br>`audience_types`<br>`new_followers`<br>`engagement_likes`<br>`media_type`<br>`is_ad`|

请求

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

方法 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) 接口。|

参数

以 URL 参数的形式传入参数。

|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
| business_id {必填} | string | TikTok 账号的开发者应用唯一识别 ID。<br>需将 [/tt_user/oauth2/token/](1833997638479041.html) 接口返回的 `open_id` 字段值传入本字段。|
| fields | string[] | 请求的字段。如果未设置，仅返回<strong>默认</strong>字段。<br><strong>默认值</strong>：`&#91;"item_id"&#93;`。<br>若想请求多个字段，`fields`  值中至少需包含 `"item_id"`。否则系统可能会报错。<br><strong>示例</strong>：`&#91;"item_id", "create_time"&#93;`。<br><p><span style="color:darkred"><b>注意</b></span>：所有视频互动指标是视频投放期间的所有数据汇总。与主页层级的指标不同，此汇总不受 60 天回溯期的限制。<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 账号用户能够为你的应用重新授予该权限。<br><br><strong>支持的字段</strong>： <ul><li>`item_id`：帖子的唯一识别 ID。</li><li>`media_type`：帖子类型。</li><li>`is_ad`：帖子是否用于广告。</li><li>`thumbnail_url`：预览帖子的缩略图 URL。</li><li>`share_url`：帖子的可分享 URL。 </li><li>`embed_url`：帖子的可嵌入 URL。 </li><li>`caption`：帖子的标题/描述。 </li><li>`video_duration`：视频时长，以秒为单位。 </li><li>`likes`：点赞数。帖子获得的总点赞数。 </li><li>`comments`：评论数。帖子获得的总评论数。 </li><li>`shares`：分享数。帖子被分享的总次数。 </li><li>`favorites`：收藏数。帖子被加入收藏的总次数。</li><li>`create_time`：帖子发布的日期和时间，采用 Unix/Epoch 格式。</li><li>`reach`：覆盖人数。至少浏览过一次你发布的内容的人数。</li><li>`video_views`：视频播放量。观众观看你的视频帖子的次数。<br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 当播放时长大于 0 且该播放是展示会话中的首次播放时，才计入播放次数。 </li><li> 如果用户滑走后又返回观看广告，计为两次展示。因此，在新的展示会话中，该播放将再次计为一次新的播放。 </li></ul> </li><li>`total_time_watched`：总播放时间。观众观看你的视频帖子的时长。  </li><li>`average_time_watched`：平均观看时长。观众观看你的视频帖子的平均时长。 </li> <li>`full_video_watched_rate`：视频完播率。观看你的完整视频帖子的观众百分比。 </li> <li>`new_followers`：新增粉丝量。新关注你的观众人数。  </li> <li>`profile_views`：主页访问量。用户通过你的帖子访问你的主页的总次数。  </li> <li>`website_clicks`：网站点击量。通过你的帖子访问你的主页的用户点击网站链接的总次数。</li>  <li>`phone_number_clicks`：电话号码点击量。通过你的帖子访问你的主页的用户点击电话号码链接的总次数。 </li> <li>`lead_submissions`：线索提交量。从通过你的帖子访问你的主页的客户中收集到的总线索量（例如报价请求、订阅电子报等）。 </li>  <li>`app_download_clicks`：应用下载链接点击量。通过你的帖子访问你的主页的用户点击应用下载链接的总次数。 </li>  <li>`email_clicks`：电子邮箱点击量。用户在浏览该特定帖子后点击你的主页中的电子邮箱按钮的总次数。</li>   <li>`address_clicks`：地址点击量。用户在浏览该特定帖子后点击你的主页中的地址按钮的总次数。</li>  <li>`video_view_retention`：受众留存。此指标表示有多少观众在视频播放一段时间后仍继续观看。</li> <li>`impression_sources`：流量来源。此指标帮助你了解视频观众的来源渠道细分数据。 </li> <li>`audience_genders`：性别。观众的性别分布情况。此数据基于多个因素得出，包括观众提供的信息。 </li>  <li>`audience_countries`：观众占比最高的国家或地区。占比最高的观众的所在国家或地区分布情况。此数据基于多个因素得出，包括观众提供的信息。  </li> <li>`audience_cities`：观众占比最高的城市。占比最高的观众的所在城市分布情况。此数据基于多个因素得出，包括观众提供的信息。</li>  <li>`audience_types`：观众类型。你的受众中新观众与回访观众、粉丝与非粉丝用户的细分数据。</li>  <li>`engagement_likes`：互动点赞数。在视频时间轴的某个时间点，点赞你的视频的观众分布情况。 </li> </ul> |
| filters | object | 对结果集应用的筛选条件。 |
#|video_ids | string[] | 用于筛选洞察信息的帖子 ID 列表。<br><br><strong>示例</strong>：`["6995316737801538821", "8015388216995316737"]`。 |
#| ad_post_only | boolean | 仅当传入 `video_ids` 时生效。<br><br>是否筛选视频 (`video_ids`)，以仅包含已授权广告主用于创建 Spark Ads 的视频帖子。<br><br>支持的值：`true`、`false`。<br>默认值：`false`。|
| cursor | integer | 分页光标。如果返回参数 `has_more` 为 true，在后续请求中将返回的光标传入此参数，以获取下一页结果。<br><br><strong>默认值</strong>：当前时间，采用 Epoch/Unix 时间戳，以毫秒为单位。 <br><br><p><span style="color:darkred"><b>注意</b></span>：光标值采用 UTC Unix 时间戳，以毫秒为单位。你可以传递定制时间戳，获取用户在所提供的时间戳之前发布的视频。 |
| max_count | integer | 为每页返回的最大视频数。<br><br><strong>默认值</strong>：10<br><br><strong>最大值</strong>：20<br><br><p><span style="color:darkred"><b>注意</b></span>：由于信任与安全政策，接口可能会返回少于 `max_count` 的视频数，即使返回参数 `has_more` 为 true 也是如此。 |

示例

(code curl http)
curl --location -g --request GET 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/?business_id=ca9b8798-fbad-4e7f-99a6-17ff809a&fields=["item_id","create_time","thumbnail_url","share_url","embed_url","caption","video_views","likes","comments","shares","reach","video_duration","full_video_watched_rate","total_time_watched","average_time_watched","impression_sources","audience_countries"]' \
--header 'Access-Token: act.sdfsdf70aa4b3dfda45b17f56f9f3jIMlBaMMzJizHyB5t6yUPGLXwJUsdfsdf'
(/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 | API 请求的唯一识别 ID。 <br><p><span style="color:darkred"><b>注意</b></span>：请记录所有 API 请求的唯一识别 ID。此字段对于问题报告和排查非常重要。 ||
| code | integer | 返回码。完整返回码列表及描述参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 ||
| message | string | 返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 ||
| data | object | 返回数据 ||
#| videos | object[] | TikTok 账号的公开帖子列表，包括在账号主页中显示的自然流量视频，以及“仅在广告中显示”的视频帖子（仅用于广告投放的视频帖子，不会在 TikTok 账号主页中显示，但会作为广告公开展示）。 ||
##| item_id | string | 帖子的唯一识别 ID。<br><br><strong>示例</strong>：6995316737801538821<br><br><strong>更新时间</strong>：实时 |`video.list`|
##|media_type|string|帖子类型。<br><br>枚举值：<ul><li>`VIDEO`：视频帖子。</li><li>`PHOTO`：图片帖子或文字帖子。</li></ul>|`video.list`|
##|is_ad | boolean | 帖子是否用于广告。<br>帖子可以通过 Spark Ads 推送或 Spark Ads 提取进行推广。详细了解 [Spark Ads](https://business-api.tiktok.com/portal/docs/create-spark-ads/v1.3)。<br>支持的值： <ul><li>`true`：帖子用于广告。</li><li>`false`：帖子未用于广告。</li></ul>|`video.list`|
##|thumbnail_url | string | 帖子内容缩略图的临时 URL。过期日期和时间包含在 x-expires 查询参数中，采用 Epoch/Unix 时间格式，以秒为单位。<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>：实时|`video.list`|
##|share_url | string | 该 TikTok 帖子的可分享 URL。请注意，网站在移动设备和桌面设备的呈现有所不同。<br><br><strong>示例</strong>：https://www.tiktok.com/@feather_in_the_w1nd/video/6994189750940863749?utm_campaign=tt4d_open_api&utm_source=6945731504177676290 <br><br><strong>更新时间</strong>：实时|`video.list`|
##|embed_url | string | 该 TikTok 帖子的可嵌入链接。此 URL 可用于在外部网站或应用中嵌入 TikTok 帖子。<br><br>如果帖子的隐私设置为“仅好友可见”或“仅自己可见”，那么无法通过此链接查看该视频。<br><br><strong>示例</strong>：https://www.tiktok.com/player/v1/1234567891234567891?music_info=1&description=1&autoplay=1&loop=1&utm_campaign=tt4d_open_api&utm_source=1234567891234567891<br><br><strong>更新时间</strong>：实时|`video.list`|
##|caption | string | 帖子描述。<br><br><strong>示例</strong>：Nuki: me and me casa 🏠 #cat #kitten #britishshorthair<br><br><strong>更新时间</strong>：实时|`video.list`|
##|video_duration | float | 视频时长，以秒为单位，保留小数点后三位。<br><br><strong>示例</strong>：20.001<br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间）|`video.list`|
##|likes | integer | 点赞数。<br>帖子获得的总点赞数。<br><br><strong>示例</strong>：243<br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间）|`video.list`|
##|comments | integer | 评论数。<br>帖子获得的总评论数。<br><br><strong>示例</strong>：10<br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间）|`video.list`|
##|shares | integer |分享数。<br>帖子被分享的总次数。<br><br>此字段显示的分享次数对应 TikTok 移动应用推荐页中显示的分享次数，包括对外分享次数，以及通过“发送给好友”按钮分享给好友的对内分享次数。<br>例如，如果一个帖子被对外分享 30 次，并在 TikTok 应用内被分享给好友 20 次，那么此字段的值将为 50。<br><br><strong>示例</strong>：10<br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间）|`video.list`|
##| favorites | integer | 收藏数。<br>帖子被加入收藏的总次数。<br><br><strong>数据来源</strong>：业务分析。<br><br><b>示例</b>：10<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间） | `video.list` |
##|create_time | string | 帖子发布的日期和时间，采用 Unix/Epoch 格式和 UTC 时区。<br><br><strong>示例</strong>：1628461703<br><br><strong>更新时间</strong>：实时 |`video.list`|
##|reach | integer |覆盖人数。  <br>至少浏览过一次你发布的内容的人数。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><strong>示例</strong>：`[&#123;impression_source: "For You", percentage: 0.7554 &#125;, &#123;impression_source: "Follow", percentage: 0.2445 &#125;, ...]` <br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间）|`video.list`|
##|video_views | integer | 视频播放量。<br>观众观看你的视频帖子的次数。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li> 当播放时长大于 0 且该播放是展示会话中的首次播放时，才计入播放次数。 </li><li> 如果用户滑走后又返回观看广告，计为两次展示。因此，在新的展示会话中，该播放将再次计为一次新的播放。</li></ul> <strong>示例</strong>：603<br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间）|`video.list`|
##|total_time_watched | float | 总播放时间。<br>观众观看你的视频帖子的时长，以秒为单位。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><strong>示例</strong>：587.024<br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间） |`video.insights`|
##|average_time_watched | Float | 平均观看时长。<br>观众观看你的视频帖子的平均时长，以秒为单位。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><strong>示例</strong>：3.862<br> <br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间） |`video.insights`|
##|full_video_watched_rate | float | 视频完播率。<br>观看你的完整视频帖子的观众百分比。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><strong>示例</strong>：0.0395<br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间）|`video.insights`|
##| new_followers | integer | 新增粉丝量。<br>新关注你的观众人数。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><b>示例</b>：123<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间） | `video.insights` |
##| profile_views | integer | 主页访问量。<br>用户通过你的帖子访问你的主页的总次数。<br><br><strong>数据来源</strong>：业务分析。<br><br><b>示例</b>：123<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间） <br><br><p><span style="color:darkred"><b>注意</b></span>：仅企业号可查看此指标的数据。 | `video.insights` |
##| website_clicks | integer | 网站点击量。<br>通过你的帖子访问你的主页的用户点击网站链接的总次数。<br><br><strong>数据来源</strong>：业务分析。<br><br><b>示例</b>：123<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间）<br><br><p><span style="color:darkred"><b>注意</b></span>：仅[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)可查看此指标的数据。 | `video.insights` |
##| phone_number_clicks | integer | 电话号码点击量。<br>通过你的帖子访问你的主页的用户点击电话号码链接的总次数。<br><br><strong>数据来源</strong>：业务分析。<br><br><b>示例</b>：123<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间）<br><br><p><span style="color:darkred"><b>注意</b></span>：仅[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)可查看此指标的数据。 | `video.insights` |
##| lead_submissions | integer | 线索提交量。<br>从通过你的帖子访问你的主页的客户中收集到的总线索量（例如报价请求、订阅电子报等）。 <br><br><strong>数据来源</strong>：业务分析。<br><br><b>示例</b>：123<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间）<br><br><p><span style="color:darkred"><b>注意</b></span>：仅[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)可查看此指标的数据。 | `video.insights` |
##| app_download_clicks | integer | 应用下载链接点击量。<br>通过你的帖子访问你的主页的用户点击应用下载链接的总次数。<br><br><strong>数据来源</strong>：业务分析。<br><br><b>示例</b>：123<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间） <br><br><p><span style="color:darkred"><b>注意</b></span>：仅[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)可查看此指标的数据。   | `video.insights` |
##| email_clicks | integer | 电子邮箱点击量。<br>用户在浏览该特定帖子后点击你的主页中的电子邮箱按钮的总次数。<br><br><strong>数据来源</strong>：业务分析。<br><br><b>示例</b>：123<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间） <br><br><p><span style="color:darkred"><b>注意</b></span>：仅[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)可查看此指标的数据。 | `video.insights` |
##| address_clicks | integer | 地址点击量。<br>用户在浏览该特定帖子后点击你的主页中的地址按钮的总次数。<br><br><strong>数据来源</strong>：业务分析。<br><br><b>示例</b>：123<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间） <br><br><p><span style="color:darkred"><b>注意</b></span>：仅[认证企业号](https://ads.tiktok.com/help/article/about-business-registration)可查看此指标的数据。 | `video.insights` |
##| video_view_retention | object[] | 受众留存。<br>此指标表示有多少观众在视频播放一段时间后仍继续观看。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间） | `video.insights` |
###| second | string | 视频时间轴上的某一秒。  |  |
###| percentage | float | 在某一秒仍在观看你的视频的观众百分比。  |  |
##|impression_sources | object[] | 流量来源。<br>此指标表示观众发现你的帖子的渠道，帮助你了解视频观众的来源渠道细分数据，并按流量贡献从高到低排序。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><strong>示例</strong>：`[&#123;impression_source: "For You", percentage: 0.7554 &#125;, &#123;impression_source: "Follow", percentage: 0.2445 &#125;, ...]`<br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间） |`video.insights`|
###| impression_source | string | 流量来源类型。<br><br>枚举值：<ul><li>`For You`：推荐页。 </li><li>`Follow`：关注页。 </li><li>`Sound`：音乐页。 </li><li>`Personal Profile`：主页。 </li><li>`Search`：搜索页。 </li><li>`Others`：其他。</li><li>`Direct Message`：私信。<br><p><span style="color:darkred"><b>注意</b></span>：`Direct Message` 值的可用性取决于你能否在 TikTok Studio 中查看相应数据。如果 TikTok Studio 中缺少相应数据，你将无法获取该值。</li></ul> ||
###| percentage | float | 来源类型的播放量百分比。 ||
##| audience_genders | object[] | 性别。<br>观众的性别分布情况。此数据基于多个因素得出，包括观众提供的信息。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间） | `video.insights` |
###| gender | string | 性别。 <br><br>枚举值：`Female`、`Male`、`Other`。  |  |
###| percentage | float | 属于该性别的观众百分比。  |  |
##|audience_countries | object[] | 观众占比最高的国家或地区。<br>占比最高的观众的所在国家或地区分布情况。此数据基于多个因素得出，包括观众提供的信息。<br><br><strong>最大数量</strong>：10。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><strong>示例</strong>：`[&#123;"country":"CA","percentage":0.0132&#125;, &#123;"country":"GB","percentage":0.0987&#125;,{"country":"US","percentage":0.7303&#125;, ...]` <br><br><strong>更新时间</strong>：T + 24-48 小时（UTC 时间） |`video.insights`|
###| country | string | [ISO 3166-1 两字母](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)国家或地区代码。 ||
###| percentage | float | 从特定国家或地区注册的观众百分比。 ||
##| audience_cities | object[] | 观众占比最高的城市。 <br>占比最高的观众的所在城市分布情况。此数据基于多个因素得出，包括观众提供的信息。<br><br><strong>最大数量</strong>：10。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><b>示例</b>：`[&#123;"city_name": "US Cincinnati","percentage": 0.597&#125;,&#123;"city_name": "US Los Angeles","percentage": 0.597&#125;,&#123;"city_name": "US Other","percentage": 17.4921&#125;,&#123;"city_name": "US Ashburn","percentage": 1.2139&#125;]`<br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间）  | `video.insights` |
###| city_name | string | 城市名称。 <br><br><b>示例</b>：美国辛辛那提。  |  |
###| percentage | float | 位于该城市的观众百分比。 <br><br><b>示例</b>：1.2139 |  |
##| audience_types | object[] | 观众类型。<br>你的受众中新观众与回访观众、粉丝与非粉丝用户的细分数据。<br><br><strong>数据来源</strong>：TikTok Studio。<br><br><b>示例</b>：`[&#123;"percentage": 0,"type": "FOLLOWER_PERCENT"&#125;,&#123;"percentage": 0.98,"type": "NEW_VIEWER"&#125;,&#123;"percentage": 1,"type": "NON_FOLLOWER_PERCENT"&#125;,&#123;"percentage": 0.02,"type": "RETURN_VIEWER"&#125;]` <br><br><b>更新时间</b>：T + 24-48 小时（UTC 时间） | `video.insights` |
###| type | string | 受众类型。<br><br>枚举值： <ul><li>`NEW_VIEWER`：新观众。首次浏览你的帖子或距离上次浏览你的帖子已超过一年的观众。 </li><li>`RETURN_VIEWER`：回访观众。过去一年内曾浏览过你的帖子的观众。 </li><li>`FOLLOWER_PERCENT`：粉丝。在 TikTok 上关注你的观众。</li><li> `NON_FOLLOWER_PERCENT`：非粉丝。未在 TikTok 上关注你的观众。 </li></ul>|  |
###| percentage | float | 属于该受众类型的观众百分比。  |  |
##| engagement_likes | object[] | 互动点赞数。<br>在视频时间轴的某个时间点，点赞你的视频的观众分布情况。<br><br><strong>数据来源</strong>：TikTok Studio。<br> <br><b>更新时间</b>：T + 24-48 小时（UTC 时间）   | `video.insights` |
###| second | string | 视频时间轴上的某一秒。  |  |
###| percentage | float | 在某一秒点赞你的视频的观众百分比。  |  |
#| cursor | integer | 用于获取下一页结果的光标，可传入后续 API 请求的光标查询参数。<br><br><strong>更新时间</strong>：实时 ||
#| has_more | boolean | 是否提供其他数据页面。<br><br><strong>更新时间</strong>：实时 ||

示例

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "2021080307532501024502410704A7306F",
    "data": {
        "videos": [
            {
                "item_id": "6990565363377392901",
                "create_time": "1627617835",
                "caption": "little coco",
                "thumbnail_url": "http://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/c85b70edfca14b7b89cc2e1e884ee268~tplv-noop.image?x-expires=1627998825&x-signature=1pMnzQjXnN%2BMWQHK0Vl2zfT%2BRoY%3D",
                "embed_url": "
https://www.tiktok.com/player/v1/1234567891234567891?music_info=1&description=1&autoplay=1&loop=1&utm_campaign=tt4d_open_api&utm_source=1234567891234567891E",
                "share_url": "https://www.tiktok.com/@feather_in_the_w1nd/video/6990565363377392901?utm_campaign=tt4d_open_api&utm_source=6979330045630218242",
                "likes": 10,
                "comments": 2,
                "shares": 0,
                "video_views": 1231,
                "reach": 154,
                "video_duration": 20.0,
                "total_time_watched": 695.942,
                "average_time_watched": 4.118,
                "full_video_watched_rate": 0.0237,
                "impression_sources": [
                    {
                        "percentage": 0.0113,
                        "impression_source": "Follow"
                    },
                    {
                        "percentage": 0.8983,
                        "impression_source": "For You"
                    },
                    {
                        "percentage": 0.0,
                        "impression_source": "Hashtag"
                    },
                    {
                        "percentage": 0.0904,
                        "impression_source": "Personal Profile"
                    },
                    {
                        "percentage": 0.0,
                        "impression_source": "Sound"
                    }
                ],
                "audience_countries": [
                    {
                        "percentage": 0.0237,
                        "country": "CA"
                    },
                    {
                        "percentage": 0.1775,
                        "country": "GB"
                    },
                    {
                        "percentage": 0.0118,
                        "country": "NL"
                    },
                    {
                        "percentage": 0.0059,
                        "country": "PR"
                    },
                    {
                        "percentage": 0.7574,
                        "country": "US"
                    },
                    {
                        "percentage": 0.0059,
                        "country": "VE"
                    }
                ]  
            }
        ],
        "cursor": 0,
        "has_more": false
    }
}
(/code)
← 获取 TikTok 账号帖子隐私设置评论 →

内容来源：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 每日平台更新简报 →