---
title: "视频搜索结果/Video search results"
method: POST
path: "/api/v1/douyin/index/fetch_item_query"
tags: ["Douyin-Index-API"]
---

# 视频搜索结果/Video search results

`POST /api/v1/douyin/index/fetch_item_query`

## 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/index/fetch_item_query`
- Auth: HTTP bearer

# [中文]
### 用途:
- 搜索抖音指数视频库，支持垂类、时长、类型、发布时间四维筛选
- 结果包含视频基础信息、播放/点赞/粉丝等核心数据
### 参数:
- 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

## Query parameters

- `query` string, required: 搜索关键词/Search keyword
- `category_id` string: 垂类ID（可通过 fetch_item_filter_options 获取）/Category ID (get from fetch_item_filter_options), 0=全部/all
- `date_type` integer: 发布时间类型（可通过 fetch_item_filter_options 获取）/Date type (get from fetch_item_filter_options), 0=不限/unlimited
- `label_type` integer: 视频类型（可通过 fetch_item_filter_options 获取）/Label type (get from fetch_item_filter_options), 0=不限/unlimited
- `duration_type` integer: 时长类型（可通过 fetch_item_filter_options 获取）/Duration type (get from fetch_item_filter_options), 0=不限/unlimited

## 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/index/fetch_item_query/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)