[中文]

用途:

获取抖音 App 中通过关键词搜索到的视频内容（V2版本接口）。

相较于 V1，返回字段更加详细，包括作者资料、视频多清晰度播放源、标签列表等。

备注:

初次请求时 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": ""
}

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

business_data[]: 搜索返回的数据列表

data_id: 数据编号（字符串，如 "0"）

type: 数据类型（1=视频）

data:

type: 同上（1）

aweme_info: 视频详细信息

基础信息:

aweme_id: 视频ID

desc: 视频描述

create_time: 发布时间（时间戳）

作者信息 (author):

uid: 用户唯一ID

short_id: 用户短ID

nickname: 用户昵称

signature: 个性签名

follower_count: 粉丝数

is_verified: 是否认证

region: 地区，如 "CN"

avatar_thumb.url_list: 小头像URL列表

avatar_medium.url_list: 中头像URL列表

avatar_larger.url_list: 大头像URL列表

enterprise_verify_reason: 企业认证信息（如"店铺账号"）

背景音乐 (music):

id_str: 音乐ID

title: 音乐标题

author: 音乐创作者昵称

play_url.url_list: 音乐播放链接列表

视频播放信息 (video):

play_addr.url_list: 播放地址列表（支持高清播放）

cover.url_list: 封面图片列表

dynamic_cover.url_list: 动态封面列表

origin_cover.url_list: 原始封面列表

duration: 时长（毫秒）

ratio: 分辨率（如"720p"）

bit_rate[]: 多码率播放信息

gear_name: 清晰度名称（如"540_2_2"）

bit_rate: 码率（单位bps）

play_addr.url_list: 对应清晰度播放地址列表

标签列表 (cha_list[]):

cha_name: 话题名（如 "#宇树科技"）

cid: 话题ID

share_url: 话题分享链接

统计信息 (statistics):

comment_count: 评论数

digg_count: 点赞数

share_count: 分享数

play_count: 播放次数

collect_count: 收藏次数

状态信息 (status):

is_delete: 是否被删除

is_private: 是否私密

allow_share: 是否允许分享

allow_comment: 是否允许评论

其他字段:

share_url: 视频外链

user_digged: 当前用户是否点赞（0=否，1=是）

cursor: 翻页游标（用于下次请求）

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

[English]

Purpose:

Fetch video search results from Douyin App using V2 API version.

Compared to V1, returns more detailed information including author details, multi-resolution video sources, and hashtags.

Notes:

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

The response contains rich video data, suitable for display, content scraping, or intelligent analysis.

Parameters:

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

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": "robot",
    "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):

business_data[]: List of returned data items

data_id: Data ID (string, e.g., "0")

type: Data type (1=Video)

data:

type: Same as above (1)

aweme_info: Detailed video information

Basic Info:

aweme_id: Video ID

desc: Video description

create_time: Creation timestamp

Author Info (author):

uid: Unique User ID

short_id: Short ID

nickname: Nickname

signature: Bio

follower_count: Follower count

is_verified: Whether verified

region: Region, e.g., "CN"

avatar_thumb.url_list: Thumbnail avatar URLs

avatar_medium.url_list: Medium avatar URLs

avatar_larger.url_list: Large avatar URLs

enterprise_verify_reason: Enterprise verification info

Music (music):

id_str: Music ID

title: Music title

author: Music creator nickname

play_url.url_list: List of play URLs

Video (video):

play_addr.url_list: Play URLs (supports HD)

cover.url_list: Cover images

dynamic_cover.url_list: Dynamic covers

origin_cover.url_list: Original covers

duration: Duration (milliseconds)

ratio: Resolution (e.g., "720p")

bit_rate[]: Multiple bitrates

gear_name: Gear name

bit_rate: Bitrate (bps)

play_addr.url_list: Play URLs

Hashtags (cha_list[]):

cha_name: Hashtag name (e.g., "#UnitreeRobot")

cid: Hashtag ID

share_url: Hashtag share link

Statistics (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 (status):

is_delete: Whether deleted

is_private: Whether private

allow_share: Whether sharing is allowed

allow_comment: Whether commenting is allowed

Other fields:

share_url: Video external share link

user_digged: Whether the user has liked (0=No, 1=Yes)

cursor: Cursor for next page

has_more: Whether more data is available (1=Yes, 0=No)

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 video 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):