TItikhub
Douyin-DouPlus-API

投放数据明细/Delivery analysis detail

Changed on

[中文]

用途:

  • DOU+ 投放数据明细（逐订单 / 逐作品的指标列表，支持分页与排序），账号 / 视频 / 直播由 query.analysisType 区分
  • 此接口需要用户提供有效的 www.douyin.com 网页版 Cookie

参数（query 透传）:

  • 字段同"投放数据概览"，额外 page（页码）、limit（每页数量）、orderByMetric（排序字段，如 create_time）、orderByType（排序方向）

返回:

  • 明细列表数据（含分页信息）

[English]

Purpose:

  • DOU+ delivery analysis detail (per-order / per-item metric list with paging & sorting); account/video/live by query.analysisType
  • Requires a valid www.douyin.com web Cookie

Parameters (query passthrough):

  • Same fields as overview, plus page, limit, orderByMetric (e.g. create_time), orderByType

Return:

  • Detail list data (with pagination)
post/api/v1/douyin/douplus/fetch_analyse_detail

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