获取视频搜索 V4/Fetch video search V4

POST

/api/u1/v1/douyin/search/fetch_video_search_v4

[中文]

用途:

按视频标题/关键词搜索视频（V4 版本），支持游标翻页。

关键词匹配的是视频标题，也可以直接传入视频ID或视频分享链接来精确定位一条视频。

备注:

本接口不支持排序、发布时间、时长、内容类型等筛选条件，只有关键词与翻页参数。

每页固定 12 条，不支持指定数量。

首次请求 cursor 传 0，翻页时传上一页响应里返回的 cursor。

参数:

keyword: 视频标题/关键词（必填），如 "猫咪"

cursor: 翻页游标（首次请求传 0）

请求体示例：

payload = {
    "keyword": "猫咪",
    "cursor": 0
}

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

匹配的视频列表，每项包含视频ID、标题、封面、时长、发布时间及互动数据等

翻页信息（下一页的 cursor、是否还有更多数据）

[English]

Purpose:

Search videos by title/keyword (V4), with cursor pagination.

The keyword matches the video title; a video ID or a video share link can also be passed
to locate one specific video.

Notes:

This endpoint has no sorting, publish time, duration or content type filters —
only the keyword and pagination parameters.

Page size is fixed at 12 and cannot be changed.

Set cursor to 0 for the first request, then pass the cursor from the previous response.

Parameters:

keyword: Video title or keyword (required), e.g., "cat"

cursor: Pagination cursor (0 for the first request)

Request Body Example:

payload = {
    "keyword": "cat",
    "cursor": 0
}

Response (common fields, actual response may contain more fields):

Matched video list; each item contains video ID, title, cover, duration, publish time
and interaction metrics

Pagination info (next cursor, whether more results are available)

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "keyword": "猫咪",
    "cursor": 0
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.tikomni.com/api/u1/v1/douyin/search/fetch_video_search_v4' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "keyword": "猫咪",
    "cursor": 0
}'

Responses

🟢200成功

application/json

Successful Response

Bodyapplication/json

Example

{}

🟠422参数错误

Modified at 2026-08-13 21:37:33

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

获取视频搜索 V5/Fetch video search V5

获取视频搜索 V4/Fetch video search V4

[中文]#

用途:#

备注:#

参数:#

请求体示例：#

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:#

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

Response (common fields, actual response may contain more fields):#