Skip to main content
POST
douyin fetch_live_room_history_list
Fetch live room history list Pricing — billed per successful call; the final charge scales by your plan multiplier. Charged only when the upstream response body code is 200.
Response structure is not yet fully documented — refer to the actual API response.

Example

Authorizations

Authorization
string
header
required

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

Body

application/json

Live room history list request parameters

User's Douyin Creator Platform Cookie (required, transmitted in request body)

Example:

"Your_Cookie_Here"

start_date
string
required

Start date in YYYY-MM-DD format (required, e.g., "2025-09-11")

Example:

"2025-09-11"

end_date
string
required

End date in YYYY-MM-DD format (required, e.g., "2025-10-11")

Example:

"2025-10-11"

limit
integer
default:400

Limit per page, default 400, max 400

Required range: x <= 400
Example:

400

need_living
integer
default:1

Include live rooms currently streaming: 0=exclude, 1=include

Example:

1

download
integer
default:0

Download: 0=no download, 1=download

Usage: Download flag (0=No download, 1=Download, default 0)

Example:

0

Response

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

Return Data Description

Returns a list of live session history, data is located in data.data.series array, each session includes:

Basic Info:

  • roomID: Live room ID
  • roomTitle: Live title
  • coverUri: Live cover image URL
  • startTime: Start time (format: "YYYY-MM-DD HH:mm:ss")
  • endTime: End time (format: "YYYY-MM-DD HH:mm:ss")
  • liveDurationWithoutPause: Duration without pause (format: "1 minute 5 seconds")
  • playStatus: Play status (4=Ended)

Traffic Data:

  • watchCnt: Total watch count
  • serverWatchUcntTdDirect: Direct watch user count (from server statistics)
  • pcu: Peak Concurrent Users
  • liveServerWatchDurationTdPavg: Average watch duration

Engagement Data:

  • serverLikeCntTd: Likes count
  • clientCommentUcntTd: Comment user count
  • liveNewFollowUcnt: New followers count

Consumption/Conversion Data:

  • liveConsumeUcnt: Consuming user count
  • liveFansConsumeUcntTd: Fan consuming user count
  • roomLiveEarnScore: Live room earn score
code
integer
default:200

HTTP status code

request_id
string | null

Unique request identifier

message
string
default:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh
string
default:请求成功,本次请求将被计费。

Response message (ZH-CN)

support
string
default: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
default:America/Los_Angeles

The timezone of the response time

docs
string | null

Link to the API Swagger documentation for this endpoint

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

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

router
string
default:""

The endpoint that generated this response

params
any
default:{}

The parameters used in the request

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.