Video Search
简介
通过关键词或过滤条件筛选视频，支持以下功能：
- 支持模糊搜索
- 支持设置过滤参数
- 支持自定义结果排序方式
接口
bash
POST /video/v1/searchrequest body
| 字段 | 类型 | 必选 | 描述 |
|---|---|---|---|
keywords | string | 否 | 搜索关键词 |
filter | object | 否 | 过滤参数 |
orderby | object | 否 | 排序参数 |
page | integer | 否 | 页码，默认值：1 |
pagesize | integer | 否 | 每页条数，默认值：10 |
lang | string | 否 | 语言设置，英语(默认值)：EN_US 中文：ZH_CN |
page*pagesize<= 5000
pagesize范围[1,100]
keywords 参数说明
- 最大长度：
120字符 - 默认值：空字符串
filter 类型object 可选值
| 字段 | 类型 | 必选 | 描述 |
|---|---|---|---|
region | string | 否 | 国家/地区` |
is_ecommerce | boolean | 否 | 是否为带货视频 1.是 |
creator_category_id | integer | 否 | 达人分类 ID |
product_category_id | integer | 否 | 商品分类 ID |
create_time_range | object | 是 | 发布时间范围 |
follower_count_range | object | 否 | 粉丝量区间，例如：{'min': 100000, 'max': 500000} |
play_count_range | object | 否 | 播放量区间，例如：{'min': 100000, 'max': 500000} |
digg_count_range | object | 否 | 点赞量区间，例如：{'min': 100000, 'max': 500000} |
interact_rate_range | object | 否 | 互动率区间，例如：{'min': 10, 'max': 20} （10%-20%） |
region 范围:
['US','GB','MX','ES','DE','IT','FR','ID','VN','MY','TH','PH','BR','JP','SG']
orderby 可选值
| 字段 | 必选 | 描述 |
|---|---|---|
follower_count | 否 | 粉丝数（降序） |
create_time | 否 | 发布时间（降序） |
play_count | 否 | 播放量（降序） |
digg_count | 否 | 点赞数（降序） |
units_sold | 否 | 带货销量（降序） |
interact_rate | 否 | 互动率（降序） |
request example
bash
curl 'https://openapi.fastmoss.com/video/v1/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
# "keywords": "test",
"filter": {
"region": "US",
"is_ecommerce": 1,
"creator_category_id": 4,
"product_category_id": 12,
"follower_count_range": {"min": 1000, "max": 100000},
# "create_time_range": {"min": 1678092800, "max": 1678697600},
# "interact_rate_range": {"min": 10, "max": 20},
},
"orderby": [{"field":"follower_count", "order":"desc"}],
# "orderby": [{"field":"create_time", "order":"desc"}],
# "orderby": [{"field":"interact_rate", "order":"desc"}],
# "orderby": [{"field":"play_count", "order":"desc"}],
# "orderby": [{"field":"digg_count", "order":"desc"}],
# "orderby": [{"field":"units_sold", "order":"desc"}],
"page": 1,
"pagesize": 10
}'response body
data.total
结果总条数
data.list
| 字段 | 类型 | 描述 |
|---|---|---|
video_id | integer | 视频 ID |
desc | string | 视频描述 |
uid | string | 达人 UID |
is_ad | integer | 广告标识，1是广告，0不是 |
region | string | 国家/地区标识 |
publish_time | integer | 视频发布时间，时间戳格式(秒) |
comment_count | integer | 评论数 |
play_count | integer | 播放数 |
digg_count | integer | 点赞数 |
share_count | integer | 分享数 |
forward_count | integer | 收藏数 |
duration | integer | 视频长度（秒） |
cover | string | 视频封面 URL |
interact_rate | float | 互动率 (如10表示10%) (deprecated) |
interact_rate_info | object | 互动率详情 |
is_ecommerce | integer | 是否为带货视频（1是，0否） |
video_url | string | TikTok视频链接 |
units_sold | integer | 带货销量 |
gmv | float | 带货销售额 |
creator | object | 达人信息 |
product_info | array[object] | 带货商品列表 |
data.list.creator 达人信息
| 字段 | 类型 | 描述 |
|---|---|---|
uid | integer | 达人 ID |
avatar | string | 头像 URL |
unique_id | string | 达人唯一 ID |
nickname | string | 昵称 |
region | string | 国家/地区 |
category | object | 达人分类 |
follower_count | integer | 粉丝数 |
data.list.product_info 带货商品列表
| 字段 | 类型 | 描述 |
|---|---|---|
product_id | string | 商品 ID |
title | string | 商品名称 |
cover | string | 商品封面图 |
region | string | 商品国家/地区 |
currency | string | 货币代码（如：USD） |
price | string | 商品售价 |
units_sold | integer | 商品销量 |
gmv | float | 商品销售额 |
category | object | 商品分类 {"l1":{"id": 12, "name": "美妆护肤"}} |
source | string | 来源，目前只有"TikTok Shop" |
detail_url | string | 商品详情页地址 |
response example
json
{
"code": 0,
"data": {
"total": 2437,
"list": [
{
"video_id": "7517469614079610142",
"desc": "#fyp #foryou #relatable #xyzbca #blowthisup ",
"uid": "6764812635147207685",
"is_ad": 0,
"cover": "https://s.500fd.com/tt_video/ogoJVwT1ZBfI2AFR9EkI8uLCpUE9AHfturaDEt~tplv-tiktokx-cropcenter-q:300:400:q72.jpeg",
"region": "US",
"publish_time": 1750297310,
"duration": 5,
"play_count": 20600000,
"share_count": 378200,
"digg_count": 3800000,
"comment_count": 16400,
"forward_count": 264159,
"interact_rate": 20.36, // deprecated
"interact_rate_info": {
"rate": 20.36,
"unit": "%"
},
"is_ecommerce": 1,
"video_url": "https://www.tiktok.com/@seenontiktokltd/video/7516849526523858199",
"creator": {
"uid": "6764812635147207685",
"avatar": "https://s.500fd.com/tt_author/d19f10b759f11d0043878ed0acbeae7f~tplv-tiktokx-cropcenter:1080:1080.jpeg",
"nickname": "Julz",
"unique_id": "julzgeekin",
"region": "US",
"category_id": 6,
"category_name": "时尚穿搭",
"follower_count": 28188
},
"units_sold": 2,
"gmv": 103,
"product_info": [
{
"product_id": "1730186290864034458",
"title": "Pacsun Men's Escape Reality Zip Up Hoodie",
"cover": "https://s.500fd.com/tt_product/97468f66b806475a9a16bcfc03826bc1~tplv-omjb5zjo8w-crop-webp:500:500.webp",
"region": "US",
"currency": "USD",
"price": "$51.96",
"units_sold": 2,
"gmv": 103.92,
"category": {
"l1": {
"id": 3,
"name": "男装与男士内衣"
}
},
"source": "TikTok Shop",
"detail_url": "https://shop.tiktok.com/view/product/1730186290864034458?region=US&local=en"
}
]
}
]
},
"message": "",
"timestamp": 1750745256,
"request_id": "7885f669-27e0-bdb2-1140-b6742978f5f1"
}