视频搜索结果/Video search results

[中文]

用途:

• 搜索抖音指数视频库，支持垂类、时长、类型、发布时间四维筛选
• 结果包含视频基础信息、播放/点赞/粉丝等核心数据

参数:

• 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

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.