video_search
搜索TikTok带货视频。支持按关键词搜索，可按播放量、点赞、销量、时长等条件筛选。
Args:
keyword (string): 搜索词
region (string): 国家/区域，默认US
video_ids (string[]): 视频id查询，最大50
video_type (string): 视频类型
product (boolean): 是否带货视频
product_id (string): 商品id
shop_id (string): 店铺id
product_category_list (string[]): 带货分类列表
play_cnt_from (integer): 播放量下限
play_cnt_to (integer): 播放量上限
like_cnt_from (integer): 点赞量下限
like_cnt_to (integer): 点赞量上限
interact_from (number): 互动率下限
interact_to (number): 互动率上限
price_from (number): 价格下限
price_to (number): 价格上限
sales_volume_from (integer): 销量下限
sales_volume_to (integer): 销量上限
sales_volume_lst30d_from (integer): 近30天销量下限
sales_volume_lst30d_to (integer): 近30天销量上限
sales_lst30d_from (number): 近30天销售额下限
sales_lst30d_to (number): 近30天销售额上限
seconds_from (integer): 时长下限(秒)
seconds_to (integer): 时长上限(秒)
pub_date_from (string): 发布时间起始，格式yyyy-MM-dd(如2024-01-01)
pub_date_to (string): 发布时间截止，格式yyyy-MM-dd(如2024-12-31)
order_field (string): 排序字段
order_type (integer): 排序方向：0降序，1升序，默认0
page_num (integer): 页码，默认1
page_size (integer): 每页数量，默认20，最大100
Returns:
object: 分页结果。
外层: {code(string): 状态码, message(string): 提示信息, success(boolean): 是否成功, data(object): 分页数据}
data: {total(integer): 数据总数, pageNum(integer): 当前页码, pageSize(integer): 页容, list(object[]): 结果集}
list元素(视频):
id (string): 视频ID
title (string): 视频标题
cover (string): 视频封面
region (string): 区域
seconds (integer): 视频时长(秒)
pubTime (string): 视频发布时间
playCnt (integer): 播放量
likeCnt (integer): 点赞数
collectCnt (integer): 收藏数
commentCnt (integer): 评论数
forwardCnt (integer): 转发数
interactionRate (number): 互动率
vqScore (string): 质量得分
currency (string): 货币
totalSalesVolume (integer): 总销量
salesVolumeLst30d (integer): 近30天销量
salesLst30d (number): 近30天销售额
creator (object): 达人信息
product (object): 商品信息
tiktokUrl (string): tiktok链接
kolspriteUrl (string): kolsprite详情链接
creator(达人信息):
id (string): 达人ID
name (string): 达人昵称
handleName (string): 达人handle
cover (string): 达人头像
region (string): 达人区域
fansCnt (integer): 粉丝数
categoryList (string[]): 达人分类
enCategoryList (string[]): 达人英文分类
product(商品信息):
id (string): 商品ID
title (string): 商品标题
imageUrl (string): 商品图片
price (number): 现价
originalPrice (number): 原价
currency (string): 货币
region (string): 商品区域
catId (string): 分类ID
catName (string): 分类名称
cnCatName (string): 中文分类名称
salesVolumeLst30d (integer): 近30天销量
totalSales (number): 总销售额
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | 国家/区域，默认US | |
| keyword | No | 搜索词 | |
| product | No | 是否带货视频 | |
| shop_id | No | 店铺id | |
| page_num | No | 页码，默认1 | |
| price_to | No | 价格上限 | |
| page_size | No | 每页数量，默认20，最大100 | |
| video_ids | No | 视频id查询，最大50 | |
| order_type | No | 排序方向：0降序，1升序，默认0 | |
| price_from | No | 价格下限 | |
| product_id | No | 商品id | |
| seconds_to | No | 时长上限(秒) | |
| video_type | No | 视频类型 | |
| interact_to | No | 互动率上限 | |
| like_cnt_to | No | 点赞量上限 | |
| order_field | No | 排序字段 | |
| play_cnt_to | No | 播放量上限 | |
| pub_date_to | No | 发布时间截止，格式yyyy-MM-dd(如2024-12-31) | |
| seconds_from | No | 时长下限(秒) | |
| interact_from | No | 互动率下限 | |
| like_cnt_from | No | 点赞量下限 | |
| play_cnt_from | No | 播放量下限 | |
| pub_date_from | No | 发布时间起始，格式yyyy-MM-dd(如2024-01-01) | |
| sales_lst30d_to | No | 近30天销售额上限 | |
| sales_volume_to | No | 销量上限 | |
| sales_lst30d_from | No | 近30天销售额下限 | |
| sales_volume_from | No | 销量下限 | |
| product_category_list | No | 带货分类列表，只支持传递一个，可选值通过product_category_list工具查询 | |
| sales_volume_lst30d_to | No | 近30天销量上限 | |
| sales_volume_lst30d_from | No | 近30天销量下限 |