[中文]

用途:

获取抖音 App 中综合搜索栏的搜索结果 V5版本（最新版本）。

支持关键词搜索,返回包含视频、用户、话题等多种类型的综合搜索结果。

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

备注:

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

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

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

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

参数:

keyword: 搜索关键词,如 "猫咪"

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

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

backtrace: 回溯参数,用于翻页 (首次请求传空字符串,翻页时使用上次响应的 backtrace)

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

请求体示例:

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

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

config: 业务配置信息

offset: 下一页的偏移游标

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

search_id: 搜索ID (用于翻页)

backtrace: 回溯参数 (用于翻页)

data[]: 搜索结果列表 (包含多种类型的内容)

type: 结果类型 (1=视频, 2=用户, 3=话题等)

aweme_info: 视频信息 (当 type=1 时)

aweme_id: 视频ID

desc: 视频描述

author: 作者信息

uid: 用户ID

nickname: 用户昵称

avatar_thumb: 头像缩略图

video: 视频播放信息

play_addr: 播放地址

cover: 封面图

duration: 视频时长(毫秒)

statistics: 统计数据

digg_count: 点赞数

comment_count: 评论数

share_count: 分享数

play_count: 播放次数

user_list: 用户信息列表 (当包含用户结果时)

challenge_list: 话题列表 (当包含话题结果时)

[English]

Purpose:

Fetch general search results from Douyin App V5 (latest version).

Supports keyword search, returns comprehensive results including videos, users, hashtags, etc.

Uses new pagination mechanism with offset and page parameters.

Notes:

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

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

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

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

Parameters:

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

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)

backtrace: Backtrace parameter for pagination (empty string for first request, use value from previous response)

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

Request Body Example:

payload = {
    "keyword": "cat",
    "offset": 0,
    "page": 0,
    "backtrace": "",
    "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[]: Search results list (contains multiple types of content)

type: Result type (1=video, 2=user, 3=hashtag, etc.)

aweme_info: Video information (when type=1)

aweme_id: Video ID

desc: Video description

author: Author information

uid: User ID

nickname: User nickname

avatar_thumb: Avatar thumbnail

video: Video playback information

play_addr: Play address

cover: Cover image

duration: Video duration (milliseconds)

statistics: Statistics

digg_count: Like count

comment_count: Comment count

share_count: Share count

play_count: Play count

user_list: User list (when results contain users)

challenge_list: Hashtag list (when results contain hashtags)

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

获取综合搜索 V5（最新）/Fetch general search V5 (Latest)

[中文]#

用途:#

备注:#

参数:#

请求体示例:#

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

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

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