OpenAPI
搜索 TikTok 达人
搜索 TikTok 达人
/v1/creators/tiktok/search- 认证方式
- X-API-Key
- 所需 scope
creator:tiktok:search- 计费
- 价格以账户生效规则为准
- 限流
- 查看当前限流规则
请求参数
该请求使用 JSON 请求体提交。
keywordstring可选搜索关键词
union_user_idsarray可选达人 union_user_id 列表,最多 200 条
展开字段
该接口暂不提供 Schema 详情。
profile_urlsarray可选达人主页链接列表,最多 200 条
展开字段
该接口暂不提供 Schema 详情。
langstring可选响应语言:cn(中文)/ en(英文),默认 en
默认值: "en"
cn · en
country_codestring可选地区(国家代码)- 多选,逗号分隔,如 'CA,MX,US'
genderstring可选性别
has_emailboolean可选是否有邮箱
has_mcnboolean可选是否绑定MCN
has_lineboolean可选是否有Line
has_zaloboolean可选是否有Zalo
language_codestring可选语言筛选,多选逗号分隔,不区分大小写,如 'en,zh'
followers_cnt_gteinteger可选粉丝数 - 最小值
0 ≤ followers_cnt_gte ≤ 1000000000
followers_cnt_lteinteger可选粉丝数 - 最大值
0 ≤ followers_cnt_lte ≤ 1000000000
last10_avg_video_views_cnt_gtenumber可选近10条视频平均播放量 - 最小值
0 ≤ last10_avg_video_views_cnt_gte ≤ 1000000000
last10_avg_video_views_cnt_ltenumber可选近10条视频平均播放量 - 最大值
0 ≤ last10_avg_video_views_cnt_lte ≤ 1000000000
last10_avg_video_interaction_rate_gtenumber可选近10条视频平均互动率 - 最小值
0 ≤ last10_avg_video_interaction_rate_gte ≤ 100
last10_avg_video_interaction_rate_ltenumber可选近10条视频平均互动率 - 最大值
0 ≤ last10_avg_video_interaction_rate_lte ≤ 100
last_video_publish_date_gtestring可选最近视频发布时间 - 开始日期(YYYY-MM-DD)
last_video_publish_date_ltestring可选最近视频发布时间 - 结束日期(YYYY-MM-DD)
product_category_id_arraystring可选带货类目ID,逗号分隔
industrystring可选三级英文类目,逗号分隔
audience_female_rate_gtenumber可选粉丝女性比例 - 最小值
0 ≤ audience_female_rate_gte ≤ 100
audience_female_rate_ltenumber可选粉丝女性比例 - 最大值
0 ≤ audience_female_rate_lte ≤ 100
audience_age_liststring可选粉丝主要年龄区间
last30day_gmv_gtenumber可选最近30天GMV - 最小值
0 ≤ last30day_gmv_gte ≤ 1000000000
last30day_gmv_ltenumber可选最近30天GMV - 最大值
0 ≤ last30day_gmv_lte ≤ 1000000000
last30day_gpm_gtenumber可选最近30天GPM - 最小值
0 ≤ last30day_gpm_gte ≤ 1000000000
last30day_gpm_ltenumber可选最近30天GPM - 最大值
0 ≤ last30day_gpm_lte ≤ 1000000000
last30day_gmv_per_buyer_gtenumber可选最近30天客单价 - 最小值
0 ≤ last30day_gmv_per_buyer_gte ≤ 1000000000
last30day_gmv_per_buyer_ltenumber可选最近30天客单价 - 最大值
0 ≤ last30day_gmv_per_buyer_lte ≤ 1000000000
last30day_commission_rate_gtenumber可选最近30天佣金率 - 最小值
0 ≤ last30day_commission_rate_gte ≤ 100
last30day_commission_rate_ltenumber可选最近30天佣金率 - 最大值
0 ≤ last30day_commission_rate_lte ≤ 100
audience_country_code_liststring可选受众国家代码,多选逗号分隔
audience_language_code_liststring可选受众语言代码,多选逗号分隔
sort_fieldstring可选排序字段:followers_cnt, last10_avg_video_views_cnt, last10_avg_video_interaction_rate
默认值: "followers_cnt"
sort_orderstring可选排序方式 asc/desc
默认值: "desc"
asc · desc
pageinteger可选页码
默认值: 1
1 ≤ page ≤ 200
sizeinteger可选每页数量
默认值: 50
1 ≤ size ≤ 100
service_levelstring可选服务等级:S1(基础)/ S2(精准触达)/ S3(深度画像),默认 S1
crm_filterobject可选私域达人过滤配置
展开字段
enabledboolean可选默认值: false
modestring可选默认值: "exclude"
exclude · include
exclude_cooperatedboolean可选默认值: false
exclude_blockedboolean可选默认值: false
require_collectedboolean可选默认值: true
group_idsarray可选展开字段
该接口暂不提供 Schema 详情。
tagsarray可选展开字段
该接口暂不提供 Schema 详情。
cooperation_statusesarray可选展开字段
该接口暂不提供 Schema 详情。
is_recommendedboolean可选is_focusedboolean可选响应
该接口暂不提供 Schema 详情。