Douyin-DouPlus-API

投放数据概览(账号/视频/直播)/Delivery analysis overview

Changed on

[中文]

用途:

  • DOU+ 投放数据概览,支持账号 / 视频 / 直播三种维度(由 query.analysisType 区分:1=账号, 2=视频, 3=直播)
  • 支持按账号、投放状态、投放目标、时间周期筛选
  • 此接口需要用户提供有效的 www.douyin.com 网页版 Cookie

参数(query 透传,关键字段):

  • startTime / endTime: 秒级时间戳字符串(周期)
  • analysisType: 1=账号, 2=视频, 3=直播
  • authorSecIdList: 账号 sec_uid 列表(账号选择,留空为全部)
  • statusList: 投放状态过滤(留空为全部)
  • metrics: 需要的指标。账号常用 stat_cost,total_play,total_like,dy_comment,dy_share,dy_follow; 直播常用 stat_cost,show_cnt,dp_live_click_source_cnt,live_follow_cnt,live_comment_cnt
  • SecondaryTargetIds / CollectWayIds: 投放目标 / 收集方式过滤

返回:

  • 概览统计数据

[English]

Purpose:

  • DOU+ delivery analysis overview for account / video / live (query.analysisType: 1=account, 2=video, 3=live)
  • Filter by account, delivery status, target and time range
  • Requires a valid www.douyin.com web Cookie

Parameters (query passthrough, key fields):

  • startTime / endTime: second timestamp strings (period)
  • analysisType: 1=account, 2=video, 3=live
  • authorSecIdList: list of account sec_uid (empty = all)
  • statusList: delivery status filter (empty = all)
  • metrics: requested metrics

Return:

  • Overview statistics
post/api/v1/douyin/douplus/fetch_analyse_overview

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

cookiestring required

用户 www.douyin.com 网页版 Cookie/User www.douyin.com web Cookie

queryobject required

分析查询对象/Analysis query object. 关键字段/key fields: startTime,endTime(秒级时间戳字符串/second timestamp string); analysisType(1=账号/account, 2=视频/video, 3=直播/live); authorSecIdList(账号 sec_uid 列表); statusList(投放状态过滤); metrics(指标列表,如 stat_cost,total_play,total_like,dy_comment,dy_share,dy_follow); SecondaryTargetIds; CollectWayIds. graph 额外/extra: dimension; detail 额外/extra: page,limit,orderByMetric,orderByType; 视频/直播分析额外/extra: liveRoomIdList

Example request

{
  "cookie": "Your_Cookie_Here",
  "query": {
    "CollectWayIds": [],
    "SecondaryTargetIds": [],
    "analysisType": 1,
    "authorSecIdList": [],
    "endTime": "1781625599",
    "metrics": [
      "stat_cost",
      "total_play",
      "play_duration_5s_rate",
      "total_like",
      "dy_comment",
      "dy_share",
      "dy_home_visited",
      "dy_follow"
    ],
    "startTime": "1780934400",
    "statusList": []
  }
}

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes