[中文]

用途:

按关键词搜索正在直播的直播间（V3 版本），返回主播资料、直播标题、封面、观众数与拉流地址等。

支持内容类关键词（如 "游戏"），响应结构与综合搜索 V3 一致（config + items + pagination）。

备注:

首次请求 offset 传 0、page 传 1，search_id 传空字符串。

翻页时把上一次响应 data.pagination 里的 offset 与 search_id 原样传回，并把 page 加 1。

data.pagination.has_more 为 0 表示已经到最后一页。

每页固定 10 条，不支持指定数量。page 上限为 200，超出会返回参数错误。

直播是实时内容，同一关键词在不同时间返回的直播间会有较大差异；偶发返回空结果时稍后重试即可。

参数:

keyword: 搜索关键词，如 "游戏"

offset: 翻页游标（首次请求传 0）

page: 页码，取值 1~200（首次请求传 1）

search_id: 搜索ID（首次请求传空字符串）

请求体示例：

payload = {
    "keyword": "游戏",
    "offset": 0,
    "page": 1,
    "search_id": ""
}

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

config: 本次搜索的配置信息（透传）

items[]: 直播间列表（已按卡片类型解包）

title: 直播标题

user_count: 当前在线观众数

owner: 主播信息（昵称、头像、抖音号等）

cover.url_list: 直播间封面图

stream_url: 拉流信息

flv_pull_url: 不同清晰度的 FLV 拉流地址（SD1 标清 / SD2 高清 / HD1 超清 / FULL_HD1 蓝光 / ORIGION 原画）

hls_pull_url: HLS 播放地址（部分直播间才有）

stats: 直播间统计数据

pagination: 翻页信息

offset: 下一页的翻页游标（原样传回）

cursor: 同 offset

search_id: 下一页的搜索ID（原样传回）

has_more: 是否还有更多数据（1=有，0=无）

next_page: 下一页页码（没有更多数据时为 null）

[English]

Purpose:

Search ongoing live rooms by keyword (V3), returning streamer profile, live title, cover,
viewer count and stream URLs.

Content keywords (e.g., "games") are supported, and the response structure matches
general search V3 (config + items + pagination).

Notes:

For the first request set offset to 0, page to 1, and search_id to an empty string.

For pagination, pass back offset and search_id from data.pagination of the previous
response, and increment page by 1.

data.pagination.has_more = 0 means the last page has been reached.

Page size is fixed at 10 and cannot be changed. page is capped at 200;
exceeding it returns a parameter error.

Live content is real-time, so the same keyword returns very different rooms over time;
retry shortly if an empty result is returned.

Parameters:

keyword: Search keyword, e.g., "games"

offset: Offset cursor (0 for the first request)

page: Page number, 1-200 (1 for the first request)

search_id: Search ID (empty for the first request)

Request Body Example:

payload = {
    "keyword": "games",
    "offset": 0,
    "page": 1,
    "search_id": ""
}

Response (common fields, actual response may contain more fields):

config: Search configuration returned by the upstream (passed through)

items[]: Live room list (already unwrapped by card type)

title: Live title

user_count: Current viewer count

owner: Streamer info (nickname, avatar, Douyin ID, etc.)

cover.url_list: Room cover images

stream_url: Stream info

flv_pull_url: FLV stream URLs by quality (SD1 / SD2 / HD1 / FULL_HD1 / ORIGION)

hls_pull_url: HLS stream URL (only for some rooms)

stats: Live room statistics

pagination: Pagination info

offset: Offset cursor for the next page (pass back as-is)

cursor: Same as offset

search_id: Search ID for the next page (pass back as-is)

has_more: Whether more results are available (1=Yes, 0=No)

next_page: Next page number (null when there are no more results)

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location 'https://api.tikhub.io/api/v1/douyin/search/fetch_live_search_v3' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "keyword": "游戏", "offset": 0, "page": 1, "search_id": "" }'

{ "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 }

获取直播搜索 V3/Fetch live search V3

[中文]

用途:

备注:

参数:

请求体示例：

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

[English]

Purpose:

Notes:

Parameters:

Request Body Example:

Response (common fields, actual response may contain more fields):

Request

Responses

获取直播搜索 V3/Fetch live search V3

[中文]#

用途:#

备注:#

参数:#

请求体示例：#

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:#

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

Response (common fields, actual response may contain more fields):#

Request

Responses

[中文]

用途:

备注:

参数:

请求体示例：

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

[English]

Purpose:

Notes:

Parameters:

Request Body Example:

Response (common fields, actual response may contain more fields):