creator_search
搜索TikTok达人/创作者。支持按昵称或关键词搜索,可按粉丝数、互动率、带货量等条件筛选。
Args:
keyword (string): 搜索词
search_type (string): 搜索方式 N:昵称,K:关键词,默认K
region (string): 国家/区域,默认US
category_list (string[]): 达人分类列表
product_category_list (string[]): 带货分类列表
fans_cnt_from (integer): 粉丝数量下限
fans_cnt_to (integer): 粉丝数量上限
fans_gr_from (number): 粉丝增长率下限
fans_gr_to (number): 粉丝增长率上限
interact_from (number): 互动率下限
interact_to (number): 互动率上限
avg_like_from (number): 平均点赞量下限
avg_like_to (number): 平均点赞量上限
play_cnt_from (integer): 平均播放量下限
play_cnt_to (integer): 平均播放量上限
video_cnt_from (integer): 视频数量下限
video_cnt_to (integer): 视频数量上限
product_cnt_from (integer): 商品数下限
product_cnt_to (integer): 商品数上限
sales_volume_from (integer): 带货销量下限
sales_volume_to (integer): 带货销量上限
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
name (string): 达人昵称
uniqueId (string): handler_name
cover (string): 头像地址
tiktokUrl (string): tiktok链接
kolspriteUrl (string): kolsprite详情链接
region (string): 面向区域
category (string[]): 达人分类
enCategory (string[]): 达人分类(英文)
goodsCategory (object[]): 带货分类,元素: {catId(string): 分类ID, catName(string): 分类名称(英文), cnCatName(string): 分类名称(中文)}
fansCnt (integer): 粉丝数量
fansGr (number): 粉丝增长率
likeCnt (integer): 点赞数
likeFansRate (number): 赞粉比
interactionRate (number): 互动率
exposure (number): 视频曝光率
videoCompletionRate (number): 完播率
avgLikeCnt (integer): 平均点赞量
avgViewsPerVideo (integer): 平均播放量
videoCnt (integer): 视频数量
lastVideoDate (string): 最后视频发布时间
productCnt (integer): 带货数
salesVolume (integer): 带货销量
gpm (number): 每千次播放销售额
currency (string): 货币
mailAddress (string): 邮箱
contactList (object[]): 联系方式列表,元素: {type(string): 联系方式类型, contactAddress(string): 联系方式地址}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | 国家/区域,默认US | |
| keyword | No | 搜索词 | |
| page_num | No | 页码,默认1 | |
| page_size | No | 每页数量,默认20,最大100 | |
| fans_gr_to | No | 粉丝增长率上限 | |
| order_type | No | 排序方向:0降序,1升序,默认0 | |
| avg_like_to | No | 平均点赞量上限 | |
| fans_cnt_to | No | 粉丝数量上限 | |
| interact_to | No | 互动率上限 | |
| order_field | No | 排序字段 | |
| play_cnt_to | No | 平均播放量上限 | |
| search_type | No | 搜索方式 N:昵称,K:关键词,默认K | |
| fans_gr_from | No | 粉丝增长率下限 | |
| video_cnt_to | No | 视频数量上限 | |
| avg_like_from | No | 平均点赞量下限 | |
| category_list | No | 达人分类列表,只支持传递一个,可选值通过creator_category_list工具查询 | |
| fans_cnt_from | No | 粉丝数量下限 | |
| interact_from | No | 互动率下限 | |
| play_cnt_from | No | 平均播放量下限 | |
| product_cnt_to | No | 商品数上限 | |
| video_cnt_from | No | 视频数量下限 | |
| sales_volume_to | No | 带货销量上限 | |
| product_cnt_from | No | 商品数下限 | |
| sales_volume_from | No | 带货销量下限 | |
| product_category_list | No | 带货分类列表,只支持传递一个,可选值通过product_category_list工具查询 |