[中文]

用途:

搜索抖音指数视频库，支持垂类、时长、类型、发布时间四维筛选

结果包含视频基础信息、播放/点赞/粉丝等核心数据

参数:

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

category_id: 垂类ID（字符串），默认 "0"=全部

常用示例：601=剧情, 602=明星, 603=综艺, 604=电影, 605=电视剧, 606=音乐,
607=二次元, 608=游戏, 609=社会时政, 612=舞蹈, 615=科技, 617=母婴,
619=生活家居, 628=美食, 629=旅行, 631=时尚, 633=体育, 635=汽车

完整列表（共 36 项，含新增垂类）请调用 fetch_item_filter_options

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秒

注意:

所有筛选参数的完整合法取值可通过 GET /fetch_item_filter_options 动态获取，
避免硬编码过期数据。

视频列表，每项包含：itemId、itemTitle、视频封面、时长、发布时间、
播放量、点赞数、评论数、分享数、作者ID、作者昵称、作者粉丝数等

[English]

Purpose:

Search the Douyin Index video library with 4-dimensional filters:
category, duration, label type, publish date

Results contain basic video info plus core metrics (plays, likes, followers, etc.)

Parameters:

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

category_id: Category ID (string), default "0"=all

Common examples: 601=Drama, 602=Celebrity, 603=Variety, 604=Movie, 605=TV Series,
606=Music, 607=Anime, 608=Games, 615=Tech, 628=Food, 629=Travel, 631=Fashion

Full list (36 items incl. newly added) available via fetch_item_filter_options

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

Note:

All filter values can be fetched dynamically via GET /fetch_item_filter_options
to avoid hard-coded outdated data.

Return:

Video list. Each item contains: itemId, itemTitle, cover, duration, publish time,
play count, like count, comment count, share count, author id/nickname/followers, etc.

[示例/Example]

搜索全部美食视频

query = "美食"
category_id = "0"

只搜美食垂类下近7天发布的15-60秒高完播率视频

query = "美食"
category_id = "628"
date_type = 7
duration_type = 6
label_type = 2

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

视频搜索结果/Video search results

[中文]

用途:

参数:

注意:

返回:

[English]

Purpose:

Parameters:

Note:

Return:

[示例/Example]

搜索全部美食视频

只搜美食垂类下近7天发布的15-60秒高完播率视频

Request

Request Code Samples

Responses

视频搜索结果/Video search results

[中文]#

用途:#

参数:#

注意:#

返回:#

[English]#

Purpose:#

Parameters:#

Note:#

Return:#

[示例/Example]#

搜索全部美食视频#

只搜美食垂类下近7天发布的15-60秒高完播率视频#

Request

Request Code Samples

Responses

[中文]

用途:

参数:

注意:

返回:

[English]

Purpose:

Parameters:

Note:

Return:

[示例/Example]

搜索全部美食视频

只搜美食垂类下近7天发布的15-60秒高完播率视频