TikTok

搜索视频

POST

/video/search

搜索指定关键字的视频，将会从以下字段进行搜索

标题（title）

描述（description）

请求参数

Header 参数

Access-Token

string

可选

示例值:

Refresh-Token

string

可选

示例值:

Body 参数multipart/form-data

keyword

string

必需

可空，关键字，留空默认不做关键字要求

示例值:

page_size

integer

页面尺寸

必需

示例值:

page_num

integer

页码

必需

示例值:

from_date

integer

可选

可空，起始时间，13 位 timestamp

示例值:

to_date

integer

可选

可空，结束时间，13 位 timestamp

示例值:

username

string

可选

可空，查询包含指定字符的用户发布的视频

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/video/search' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Refresh-Token: {{Refresh-Token}}' \
--form 'keyword=""' \
--form 'page_size=""' \
--form 'page_num=""' \
--form 'from_date=""' \
--form 'to_date=""' \
--form 'username=""'

返回响应

🟢200成功

application/json

Body

base

object (响应状态)

必需

code

integer

必需

msg

string

必需

data

object

必需

items

array[object (视频) {12}]

必需

total

integer

查询的全部结果数量

必需

示例

{
    "base": {
        "code": 10000,
        "msg": "success"
    },
    "data": {
        "items": [
            {
                "id": "483675103821824000",
                "user_id": "483675103821824000",
                "video_url": "https://west2.online/video-example.mp4",
                "cover_url": "https://west2.online/video-example.jpeg",
                "title": "west2-online",
                "description": "west2-online",
                "visit_count": 0,
                "like_count": 0,
                "comment_count": 0,
                "created_at": "1970-01-01 08:00:00",
                "updated_at": "1970-01-01 08:00:00",
                "deleted_at": "1970-01-01 08:00:00"
            }
        ],
        "total": 100
    }
}

🟢200成功

热门排行榜

点赞操作