[中文]

用途:

获取抖音 App 中直播搜索的结果 V4版本（最新版本）。

专门用于搜索正在进行的直播间,返回符合关键词的直播列表。

使用新的分页机制,通过 offset 和 page 参数进行翻页。

备注:

这是直播搜索的最新版本,推荐优先使用此接口。

初次请求时 offset 和 page 均传 0,search_id 传空字符串。

翻页时从上一次响应中获取 offset 和 search_id,page 每次加 1。

返回数据结构包含 config (业务配置) 和 data (业务数据) 两部分。

返回的直播间信息包括主播资料、观看人数、直播标题、拉流地址等。

参数:

keyword: 搜索关键词,如 "游戏直播"

offset: 偏移游标,用于翻页 (首次请求传 0)

page: 页码,用于翻页 (首次请求传 0,之后每次加 1)

search_id: 搜索ID,用于翻页 (首次请求传空字符串,翻页时使用上次响应的 search_id)

请求体示例:

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

返回(部分常用字段,实际返回字段更多,一切以实际响应为准):

config: 业务配置信息

offset: 下一页的偏移游标

has_more: 是否还有更多数据 (1=有, 0=无)

search_id: 搜索ID (用于翻页)

data[]: 直播搜索结果列表

type: 结果类型 (通常为 999,表示直播类型)

aweme_info: 直播间基本信息

room_id: 直播间ID

title: 直播标题

status: 直播状态 (2=正在直播, 4=已结束)

user_count: 当前观看人数

total_user: 累计观看人数

create_time: 直播开始时间戳

owner: 主播信息

id: 主播ID

sec_uid: 加密主播ID

nickname: 主播昵称

avatar_thumb: 主播头像缩略图

avatar_medium: 主播中等尺寸头像

avatar_larger: 主播高清头像

follow_info: 关注信息

follower_count: 粉丝数

following_count: 关注数

stream_url: 拉流地址信息

flv_pull_url: FLV格式拉流地址

FULL_HD1: 蓝光画质

HD1: 超清画质

SD1: 标清画质

SD2: 高清画质

hls_pull_url: HLS格式拉流地址 (可选)

rtmp_pull_url: RTMP格式拉流地址 (可选)

cover: 直播间封面信息

url_list[]: 封面图URL列表

stats: 直播间统计数据

total_user: 总观看人数

like_count: 点赞数

user_count_str: 观看人数显示文本

mosaic_status: 马赛克状态 (用于内容审核)

room_tags[]: 直播间标签列表

id: 标签ID

name: 标签名称

[English]

Purpose:

Fetch live stream search results from Douyin App V4 (latest version).

Specifically designed for searching ongoing live streams, returns a list of live rooms matching the keyword.

Uses new pagination mechanism with offset and page parameters.

Notes:

This is the latest version of live search, recommended for priority use.

For the first request, set offset and page to 0, search_id to empty strings.

For pagination, obtain offset, and search_id from the previous response, increment page by 1.

Response structure contains config (business configuration) and data (business data).

Returned live room information includes streamer profile, viewer count, title, stream URLs, etc.

Parameters:

keyword: Search keyword, e.g., "gaming live"

offset: Offset cursor for pagination (0 for first request)

page: Page number for pagination (0 for first request, increment by 1 for each subsequent request)

search_id: Search ID for pagination (empty string for first request, use value from previous response)

Request Body Example:

payload = {
    "keyword": "gaming live",
    "offset": 0,
    "page": 0,
    "search_id": ""
}

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

config: Business configuration

offset: Next page offset cursor

has_more: Whether there are more results (1=yes, 0=no)

search_id: Search ID for pagination

backtrace: Backtrace parameter for pagination

data[]: Live stream search results list

type: Result type (usually 999, indicating live stream type)

aweme_info: Live room basic information

room_id: Live room ID

title: Live stream title

status: Live status (2=streaming, 4=ended)

user_count: Current viewer count

total_user: Total viewer count

create_time: Stream start timestamp

owner: Streamer information

id: Streamer ID

sec_uid: Encrypted streamer ID

nickname: Streamer nickname

avatar_thumb: Streamer avatar thumbnail

avatar_medium: Streamer medium size avatar

avatar_larger: Streamer large size avatar

follow_info: Follow information

follower_count: Follower count

following_count: Following count

stream_url: Stream URL information

flv_pull_url: FLV format stream URLs

FULL_HD1: Full HD quality

HD1: HD quality

SD1: SD quality

SD2: High quality

hls_pull_url: HLS format stream URLs (optional)

rtmp_pull_url: RTMP format stream URLs (optional)

cover: Live room cover information

url_list[]: Cover image URL list

stats: Live room statistics

total_user: Total viewer count

like_count: Like count

user_count_str: Viewer count display text

mosaic_status: Mosaic status (for content moderation)

room_tags[]: Live room tag list

id: Tag ID

name: Tag name

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "keyword": "猫咪",
    "offset": 0,
    "page": 0,
    "backtrace": "",
    "search_id": ""
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

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

🟠422Parameter Error

获取直播搜索 V4（最新）/Fetch live search V4 (Latest)

[中文]#

用途:#

备注:#

参数:#

请求体示例:#

返回(部分常用字段,实际返回字段更多,一切以实际响应为准):#

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

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