---
title: "获取视频搜索 V3/Fetch video search V3"
method: POST
path: "/api/v1/douyin/search/fetch_video_search_v3"
tags: ["Douyin-Search-API"]
---

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

`POST /api/v1/douyin/search/fetch_video_search_v3`

## Request

- Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tikhub.io/api/v1/douyin/search/fetch_video_search_v3`
- Auth: HTTP bearer

# [中文]
### 用途:
- 按关键词搜索视频（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秒

### 请求体示例：
```json
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:
```json
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 body

- VideoSearchV3Request
  - `query` string: 搜索关键词/Search keyword
  - `date_type` integer: 发布时间筛选：0=不限, 3=近3天, 7=近7天, 30=近一个月/Publish date filter: 0=any, 3=last 3 days, 7=last 7 days, 30=last 30 days
  - `label_type` integer: 视频类型筛选：0=不限, 1=低粉爆款, 2=高完播率, 3=高涨粉率, 4=高点赞率/Video type filter: 0=any, 1=low-follower hit, 2=high completion rate, 3=high follower growth, 4=high like rate
  - `duration_type` integer: 时长筛选：0=不限, 1=0-15秒, 6=15-60秒, 7=60-120秒, 8=120-180秒, 9=大于180秒/Duration filter: 0=any, 1=0-15s, 6=15-60s, 7=60-120s, 8=120-180s, 9=over 180s

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-01** `50f9ec6e1cd3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/douyin/search/fetch_video_search_v3/post.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)