文档导航

OpenAPI

搜索 TikTok 达人

搜索 TikTok 达人

POST/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 详情。