[中文]

用途:

获取抖音 App 中综合搜索栏的搜索结果（非单独视频搜索）。

此接口稳定性可能不如 V1版本，作为备用接口。

支持关键词、排序方式、发布时间、视频时长、内容类型等筛选条件。

支持翻页查询，通过 cursor 和 search_id 分页。

备注:

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

返回的内容包含视频、作者、话题标签、播放信息、音乐、互动数据等丰富信息。

参数:

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

cursor: 翻页游标（首次请求传 0，翻页时使用上次响应的 cursor）

sort_type: 排序方式

0: 综合排序

1: 最多点赞

2: 最新发布

publish_time: 发布时间筛选

0: 不限

1: 最近一天

7: 最近一周

180: 最近半年

filter_duration: 视频时长筛选

0: 不限

0-1: 1 分钟以内

1-5: 1-5 分钟

5-10000: 5 分钟以上

content_type: 内容类型筛选

0: 不限

1: 视频

2: 图片

3: 文章

search_id: 搜索ID（分页时使用）

请求体示例：

payload = {
  "keyword": "猫咪",
  "cursor": 0,
  "sort_type": "0",
  "publish_time": "0",
  "filter_duration": "0",
  "content_type": "0",
  "search_id": ""
}

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

data: 搜索结果列表

type: 结果类型（通常为 1）

aweme_info: 视频详细信息

aweme_id: 视频ID

desc: 视频描述内容

author: 作者信息

uid: 用户唯一ID

nickname: 用户昵称

is_verified: 是否认证用户（True=已认证，False=未认证）

region: 用户地区，如 "CN"

avatar_thumb.url_list: 缩略头像地址列表

avatar_medium.url_list: 中等尺寸头像地址列表

avatar_larger.url_list: 高清头像地址列表

music: 背景音乐信息

id_str: 音乐ID

title: 音乐标题，如"原创声音"

author: 音乐作者昵称

play_url.url_list: 音乐播放地址列表

cha_list: 关联话题标签列表

cha_name: 话题名（例如 "#猫宝宝"）

share_url: 话题分享链接

video: 视频播放与封面信息

play_addr.url_list: 视频播放地址列表

cover.url_list: 视频封面地址列表

dynamic_cover.url_list: 动态封面地址列表

origin_cover.url_list: 原始封面地址列表

width: 视频宽度（像素）

height: 视频高度（像素）

ratio: 视频分辨率比例（如540p）

duration: 视频时长（单位：毫秒）

download_addr.url_list: 带水印下载地址

statistics: 视频统计信息

comment_count: 评论数

digg_count: 点赞数

share_count: 分享数

play_count: 播放次数

collect_count: 收藏次数

status: 视频发布状态

is_delete: 是否被删除

is_private: 是否设为私密

allow_share: 是否允许分享

allow_comment: 是否允许评论

share_url: 视频外部分享链接

[English]

Purpose:

Fetch search results from Douyin App's general search tab (not standalone video search).

This API may be less stable than V1, serving as a backup.

Supports filtering by keyword, sort type, publish time, video duration, and content type.

Supports pagination through cursor and search_id.

Notes:

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

The response contains rich information including video details, author info, music, hashtags, playback info, and interaction metrics.

Parameters:

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

cursor: Pagination cursor (0 for the first page, use the last response cursor for subsequent pages)

sort_type: Sorting method

0: Comprehensive

1: Most likes

2: Latest

publish_time: Publish time filter

0: Unlimited

1: Last day

7: Last week

180: Last half year

filter_duration: Video duration filter

0: Unlimited

0-1: Within 1 minute

1-5: 1 to 5 minutes

5-10000: More than 5 minutes

content_type: Content type filter

0: Unlimited

1: Video

2: Picture

3: Article

search_id: Search ID used for pagination

Request Body Example:

payload = {
    "keyword": "cat",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

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

data: List of search result items

type: Result type (usually 1)

aweme_info: Video detailed information

aweme_id: Video ID

desc: Video description

author:

uid: Author's user ID

nickname: Author's nickname

is_verified: Whether the author is verified

region: Author's region

avatar_thumb.url_list: List of thumbnail avatar URLs

avatar_medium.url_list: List of medium size avatar URLs

avatar_larger.url_list: List of large size avatar URLs

music:

id_str: Music ID

title: Music title

author: Music creator's name

play_url.url_list: List of music play URLs

cha_list:

cha_name: Hashtag name

share_url: Hashtag share URL

video:

play_addr.url_list: List of video play URLs

cover.url_list: List of cover image URLs

dynamic_cover.url_list: List of dynamic cover URLs

origin_cover.url_list: List of original cover URLs

width: Video width (pixels)

height: Video height (pixels)

ratio: Resolution ratio (e.g., 540p)

duration: Duration in milliseconds

download_addr.url_list: List of video download URLs

statistics:

comment_count: Number of comments

digg_count: Number of likes

share_count: Number of shares

play_count: Number of plays

collect_count: Number of collects

status:

is_delete: Whether the video is deleted

is_private: Whether the video is private

allow_share: Whether sharing is allowed

allow_comment: Whether commenting is allowed

share_url: External share link

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

keyword

string

Keyword

optional

关键词 / Keyword

Default:

猫咪

cursor

integer

Cursor

optional

偏移游标，用于翻页，从上一次请求返回的响应中获取 / Offset cursor for pagination, obtained from the last response

Default:

sort_type

string

Sort Type

optional

排序方式：0=综合排序 1=最多点赞 2=最新发布 / Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest

Default:

publish_time

string

Publish Time

optional

发布时间筛选：0=不限 1=最近一天 7=最近一周 180=最近半年 / Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year

Default:

filter_duration

string

Filter Duration

optional

视频时长过滤：0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上 / Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes

Default:

content_type

string

Content Type

optional

内容类型：0=不限 1=视频 2=图片 3=文章 / Content type: 0=All, 1=Video, 2=Picture, 3=Article

Default:

search_id

string

Search Id

optional

搜索ID，用于翻页，从上一次请求返回的响应中获取 / Search ID for pagination, obtained from the last response

Default:

Example

{
    "keyword": "猫咪",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

code

integer

Code

optional

HTTP status code | HTTP状态码

Default:

200

router

string

Router

optional

The endpoint that generated this response | 生成此响应的端点

Default:

params

Params

optional

The parameters used in the request | 请求中使用的参数

Default:

{}

data

Data

optional

The response data | 响应数据

Any of

null

Example

{
    "code": 200,
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取综合搜索 V2/Fetch general search V2

[中文]#

用途:#

备注:#

参数:#

请求体示例：#

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

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

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

Request

Request samples

Responses

[中文]

用途:

备注:

参数:

请求体示例：

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

[English]

Purpose:

Notes:

Parameters:

Request Body Example:

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