[中文]

用途:

获取抖音 App 中直播搜索结果（V3 版本）。

返回丰富的直播间信息，包括主播资料、直播标题、封面图、观众数、拉流播放地址等。

备注:

仅返回直播内容，不包含其他内容。

初次请求时 offset 传入 0，search_id 传空字符串。

翻页查询时使用上次响应返回的 cursor 和 search_id。

参数:

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

offset: 偏移量（首次请求传 0，后续使用返回的 cursor 值）

search_id: 搜索ID（首次请求传空，翻页时从上次响应中获取）

JSON Path-1 : $.extra.logid

JSON Path-2 : $.log_pb.impr_id

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

status_code: 状态码（0表示成功）

cursor: 翻页游标，用于获取下一页数据

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

data[]: 直播数据列表，每个直播间包含：

type: 结果类型（固定为1）

lives: 直播信息

aweme_id: 关联内容ID

author: 主播信息

uid: 主播用户ID

short_id: 短ID

nickname: 主播昵称

avatar_thumb.url_list: 缩略头像URL列表

avatar_medium.url_list: 中等头像URL列表

avatar_larger.url_list: 大头像URL列表

room_id: 直播间ID

room_cover.url_list: 直播间封面图URL列表

video: 视频信息

tags[]: 直播标签列表

title: 标签标题

url.url_list: 标签图标URL

rawdata: 原始直播间数据（JSON字符串）

title: 直播标题

user_count: 当前观看人数

stream_url: 拉流地址

flv_pull_url: FLV 拉流地址（按清晰度分类）

FULL_HD1: 蓝光

HD1: 超清

SD1: 标清

SD2: 高清

hls_pull_url: HLS 拉流地址（可选）

cover.url_list: 直播间封面

size: 分辨率（如 1920x1080）

stats.total_user: 观众总数

guide_search_words[]: 推荐搜索词列表

word: 推荐词

type: 类型

extra: 额外信息

now: 服务器时间戳

logid: 日志ID，可用作下次搜索的 search_id

search_request_id: 搜索请求ID

log_pb: 日志追踪信息

impr_id: 展示ID，可用作下次搜索的 search_id

[English]

Purpose:

Fetch live stream search results (Version 3) from Douyin App.

Provides detailed information about each live room including host info, room title, cover images, viewer counts, and stream URLs.

Notes:

Only live streaming content is returned.

Set offset to 0 and search_id to an empty string for the first request.

For pagination, use the cursor and search_id from the last response.

Parameters:

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

offset: Offset (0 for the first request, use returned cursor value for subsequent requests)

search_id: Search ID (empty for first request, obtained from last response for pagination)

JSON Path-1 : $.extra.logid

JSON Path-2 : $.log_pb.impr_id

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

status_code: Status code (0 means success)

cursor: Pagination cursor for next page

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

data[]: List of live stream data, each live room contains:

type: Result type (fixed to 1)

lives: Live stream information

aweme_id: Related content ID

author: Streamer information

uid: Streamer's user ID

short_id: Short ID

nickname: Streamer's nickname

avatar_thumb.url_list: Thumbnail avatar URLs

avatar_medium.url_list: Medium avatar URLs

avatar_larger.url_list: Large avatar URLs

room_id: Live room ID

room_cover.url_list: Room cover image URLs

video: Video information

tags[]: Live stream tags list

title: Tag title

url.url_list: Tag icon URLs

rawdata: Raw live room data (JSON string)

title: Live title

user_count: Current viewer count

stream_url: Stream URLs

flv_pull_url: FLV stream URLs by resolution

FULL_HD1: Ultra HD

HD1: Super HD

SD1: Standard

SD2: High

hls_pull_url: HLS stream URL (optional)

cover.url_list: Room cover image

size: Resolution (e.g., 1920x1080)

stats.total_user: Total viewer count

guide_search_words[]: Recommended search words list

word: Recommended word

type: Type

extra: Extra information

now: Server timestamp

logid: Log ID, can be used as search_id for next search

search_request_id: Search request unique ID

log_pb: Log tracking information

impr_id: Impression ID, can be used as search_id for next search

[示例/Example]：

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

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

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

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

[中文]#

用途:#

备注:#

参数:#

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

[English]#

Purpose:#

Notes:#

Parameters:#

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

[示例/Example]：#

Request