Skip to main content
POST
tiktok get_video_list_analytics
获取创作者视频列表分析 计费 — 按成功调用计费,最终扣费按你的套餐倍率浮动。仅当上游响应体 code 为 200 时计费。
响应结构尚未完整文档化 —— 以实际调用为准。

示例

请求规范

  • 方法与路径: POST /apis/v1/tikhub/tiktok/creator/get_video_list_analytics
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/tikhub/tiktok/creator/get_video_list_analytics
  • Runtime 事实版本: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

公开参考价格:每次成功请求 $0.001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.001
  • 计费依据: fixed_success
  • 公开参考倍率: 1.0
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

User Cookie String

page
integer
默认值:0

Page number, default is the first page 0

proxy
string | null
默认值:""

Optional HTTP proxy address, can be omitted if not used - Example format: http://username:password@host:port

rules
string
默认值:VIDEO_LIST_PUBLISH_TIME

List sorting rules, default is by publish time. Available options: - "VIDEO_LIST_PUBLISH_TIME": Sort by video publish time - "VIDEO_LIST_GMV": Sort by gross merchandise value (GMV) - "VIDEO_LIST_DIRECT_GMV": Sort by direct GMV - "VIDEO_LIST_VV_CNT": Sort by video view count - "VIDEO_LIST_ITEM_SOLD_CNT": Sort by number of items sold - "VIDEO_LIST_CTR": Sort by click-through rate - "VIDEO_LIST_COMPLETION_RATE": Sort by video completion rate - "VIDEO_LIST_LIKE_CNT": Sort by number of likes - "VIDEO_LIST_NEW_FOLLOWER_CNT": Sort by number of new followers

start_date
string
默认值:04-01-2025

Query Start Date, e.g. '04-01-2025'

响应

Successful response. The outer object follows ResponseModel; the endpoint-specific payload is in data.

Response Fields

  • segments (List of segmented data):
    • time_selector: Time range settings (start/end timestamps, timezone, locale)
    • filter.creator_id: Creator account ID
    • list_control:
      • rules: List sorting rules (typically by publish time descending)
      • next_pagination: Pagination information (has more pages, current page, total pages, total records)
    • timed_lists: List of videos for each time range, including:
      • video_meta:
        • item_id: Video Item ID
        • name: Video title
        • publish_time: Video publish time (Unix timestamp)
        • duration: Video duration (seconds)
        • video_play_info: Video play resources (cover image, playback URL, etc.)
      • new_follower_cnt: Number of new followers during the video's period
      • vv_cnt: Video views count
      • ctr: Click Through Rate for associated products
      • gmv.amount: Gross Merchandise Value generated by the video
      • item_sold_cnt: Number of items sold due to the video
      • direct_gmv.amount: Direct GMV from the video
      • completion_rate: Video completion rate

Return

  • Detailed video list and performance analysis for the creator account
cache_message
string | null
默认值:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh
string | null
默认值:本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

code
integer
默认值:200

HTTP 状态码

data
any

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.

docs
string | null

Link to the API Swagger documentation for this endpoint

message
string
默认值:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh
string
默认值:请求成功,本次请求将被计费。

Response message (ZH-CN)

params
any
默认值:{}

The parameters used in the request

request_id
string | null

Unique request identifier

router
string
默认值:""

The endpoint that generated this response

support
string
默认值:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time
string

The time the response was generated

time_stamp
integer

The timestamp the response was generated

time_zone
string
默认值:America/Los_Angeles

The timezone of the response time