Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

获取创作者视频概览/Get Creator Video Overview

POST

https://api.tikhub.io/api/v1/tiktok/creator/get_video_analytics_summary

TikTok-Creator-API

Last modified:2025-12-13 05:20:20

OperationId:get_video_analytics_summary_api_v1_tiktok_creator_get_video_analytics_summary_post

[中文]

用途:

获取 TikTok Shop 创作者账号在指定时间范围内的视频表现概览。

默认统计从调用当天向前 30 天的数据（或按平台设定的自然月分段）。

适合用于视频表现分析，例如视频数量、播放量、粉丝增长、成交数据等。

返回内容说明:

segments（分段数据列表）:

time_selector: 时间范围设置信息（周期、起止时间戳、时区、语言）

filter.creator_id: 创作者账号 ID

timed_stats: 每个时间段的视频表现数据，包含：

vv_cnt: 视频播放量（Video Views Count）

new_follower_cnt: 新增粉丝数量

video_cnt: 发布视频数量

gmv.amount: 视频带货产生的 GMV 金额

items_sold: 售出商品数量

备注:

此接口仅适用于 TikTok Shop 创作者账号。

如果某个时间段无数据，返回的 stats 字段可能为空 {}。

参数:

cookie: 用户 Cookie 字符串（用于身份认证）

proxy: 可选 HTTP 代理地址，如不使用可省略

示例格式: http://username:password@host:port

创作者账号视频表现概览

[English]

Purpose:

Retrieve a video performance overview for a TikTok Shop creator account over a specified time range.

By default, the API fetches data for the past 30 days (or full calendar month based on the platform settings).

Useful for analyzing metrics like video count, views, new followers, and generated GMV.

Response Fields:

segments (List of segmented data):

time_selector: Time period settings (period, start/end timestamps, timezone, locale)

filter.creator_id: Creator account ID

timed_stats: Video performance statistics for each time segment, including:

vv_cnt: Video Views Count

new_follower_cnt: Number of new followers

video_cnt: Number of videos published

gmv.amount: Gross Merchandise Value generated by videos

items_sold: Number of items sold

Notes:

This API is only available for TikTok Shop creator accounts.

If no data is available for a time segment, the stats field might be an empty {}.

Parameters:

cookie: User Cookie string for authentication

proxy: Optional HTTP proxy address, can be omitted if not used

Example format: http://username:password@host:port

Return:

Creator account video performance overview

[示例/Example]

{
  "cookie": "your_cookie"
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "cookie": "Your_Cookie_String",
    "proxy": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.tikhub.io/api/v1/tiktok/creator/get_video_analytics_summary' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cookie": "Your_Cookie_String",
    "proxy": "string"
}'

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

Modified at 2025-12-13 05:20:20

获取创作者直播概览/Get Creator Live Overview

获取创作者视频列表分析/Get Creator Video List Analytics

获取创作者视频概览/Get Creator Video Overview

[中文]#

用途:#

返回内容说明:#

备注:#

参数:#

返回:#

[English]#

Purpose:#

Response Fields:#

Notes:#

Parameters:#

Return:#

[示例/Example]#