[中文]

用途:

按关键词搜索视频（V3 版本），支持发布时间、视频类型、时长三维筛选。

结果除视频基础信息外，还带播放量、点赞数、作者粉丝数等运营指标，适合做内容选题与竞品分析。

备注:

不支持翻页，返回的是当前筛选条件下的一批结果。

三个筛选参数都是可选的，全部留默认值即为不限。

参数:

query: 搜索关键词（必填），如 "美食"

date_type: 发布时间筛选，默认 0=不限

可选值：0=不限, 3=近3天, 7=近7天, 30=近一个月

label_type: 视频类型（精选标签），默认 0=不限

可选值：0=不限, 1=低粉爆款, 2=高完播率, 3=高涨粉率, 4=高点赞率

duration_type: 时长筛选，默认 0=不限

可选值：0=不限, 1=0-15秒, 6=15-60秒, 7=60-120秒, 8=120-180秒, 9=大于180秒

请求体示例：

payload = {
    "query": "美食",
    "date_type": 7,
    "label_type": 2,
    "duration_type": 6
}

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

视频列表，每项包含：

itemId: 视频ID

itemTitle: 视频标题

视频封面、时长、发布时间

播放量、点赞数、评论数、分享数

authorId: 作者ID

作者昵称、作者粉丝数

[English]

Purpose:

Search videos by keyword (V3), with 3-dimensional filters: publish date, video type, duration.

Besides basic video info, results carry operational metrics such as play count, like count and
author follower count — useful for content research and competitor analysis.

Notes:

Pagination is not supported; it returns one batch of results for the current filters.

All three filters are optional; leaving them at their defaults means no filtering.

Parameters:

query: Search keyword (required), e.g., "food"

date_type: Publish date filter, default 0=any

Valid values: 0=any, 3=last 3 days, 7=last 7 days, 30=last 30 days

label_type: Video type (quality tag), default 0=any

Valid values: 0=any, 1=low-follower hit, 2=high completion rate,
3=high follower growth, 4=high like rate

duration_type: Duration filter, default 0=any

Valid values: 0=any, 1=0-15s, 6=15-60s, 7=60-120s, 8=120-180s, 9=over 180s

Request Body Example:

payload = {
    "query": "food",
    "date_type": 7,
    "label_type": 2,
    "duration_type": 6
}

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

Video list. Each item contains:

itemId: Video ID

itemTitle: Video title

Cover, duration, publish time

Play count, like count, comment count, share count

authorId: Author ID

Author nickname and follower count

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

{
    "query": "美食",
    "date_type": 0,
    "label_type": 0,
    "duration_type": 0
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

获取视频搜索 V3/Fetch video search V3

[中文]

用途:

备注:

参数:

请求体示例：

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

[English]

Purpose:

Notes:

Parameters:

Request Body Example:

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

Request

Request Code Samples

Responses

获取视频搜索 V3/Fetch video search V3

[中文]#

用途:#

备注:#

参数:#

请求体示例：#

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

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

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

Request

Request Code Samples

Responses

[中文]

用途:

备注:

参数:

请求体示例：

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

[English]

Purpose:

Notes:

Parameters:

Request Body Example:

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