[中文]

用途:

• 按关键词搜索视频（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