CreatiVaultCreatiVault
SkillsOpenAPIDownload schema
Documentation navigation

OpenAPI

creators tiktok search

POST/v1/creators/tiktok/search
Authentication
X-API-Key
Required scope
creator:tiktok:search
Billing
Pricing follows your active account rules
Rate limits
View your active rate limits

Parameters

Send this request as a JSON body.

keywordstringOptional

搜索关键词

union_user_idsarrayOptional

达人 union_user_id 列表，最多 200 条

Show fields

Schema details are unavailable for this endpoint.

profile_urlsarrayOptional

达人主页链接列表，最多 200 条

Show fields

Schema details are unavailable for this endpoint.

langstringOptional

响应语言：cn（中文）/ en（英文），默认 en

Default: "en"

cn · en

country_codestringOptional

地区（国家代码）- 多选，逗号分隔，如 'CA,MX,US'

genderstringOptional

性别

has_emailbooleanOptional

是否有邮箱

has_mcnbooleanOptional

是否绑定MCN

has_linebooleanOptional

是否有Line

has_zalobooleanOptional

是否有Zalo

language_codestringOptional

语言筛选，多选逗号分隔，不区分大小写，如 'en,zh'

followers_cnt_gteintegerOptional

粉丝数 - 最小值

0 ≤ followers_cnt_gte ≤ 1000000000

followers_cnt_lteintegerOptional

粉丝数 - 最大值

0 ≤ followers_cnt_lte ≤ 1000000000

last10_avg_video_views_cnt_gtenumberOptional

近10条视频平均播放量 - 最小值

0 ≤ last10_avg_video_views_cnt_gte ≤ 1000000000

last10_avg_video_views_cnt_ltenumberOptional

近10条视频平均播放量 - 最大值

0 ≤ last10_avg_video_views_cnt_lte ≤ 1000000000

last10_avg_video_interaction_rate_gtenumberOptional

近10条视频平均互动率 - 最小值

0 ≤ last10_avg_video_interaction_rate_gte ≤ 100

last10_avg_video_interaction_rate_ltenumberOptional

近10条视频平均互动率 - 最大值

0 ≤ last10_avg_video_interaction_rate_lte ≤ 100

last_video_publish_date_gtestringOptional

最近视频发布时间 - 开始日期(YYYY-MM-DD)

last_video_publish_date_ltestringOptional

最近视频发布时间 - 结束日期(YYYY-MM-DD)

product_category_id_arraystringOptional

带货类目ID，逗号分隔

industrystringOptional

三级英文类目，逗号分隔

audience_female_rate_gtenumberOptional

粉丝女性比例 - 最小值

0 ≤ audience_female_rate_gte ≤ 100

audience_female_rate_ltenumberOptional

粉丝女性比例 - 最大值

0 ≤ audience_female_rate_lte ≤ 100

audience_age_liststringOptional

粉丝主要年龄区间

last30day_gmv_gtenumberOptional

最近30天GMV - 最小值

0 ≤ last30day_gmv_gte ≤ 1000000000

last30day_gmv_ltenumberOptional

最近30天GMV - 最大值

0 ≤ last30day_gmv_lte ≤ 1000000000

last30day_gpm_gtenumberOptional

最近30天GPM - 最小值

0 ≤ last30day_gpm_gte ≤ 1000000000

last30day_gpm_ltenumberOptional

最近30天GPM - 最大值

0 ≤ last30day_gpm_lte ≤ 1000000000

last30day_gmv_per_buyer_gtenumberOptional

最近30天客单价 - 最小值

0 ≤ last30day_gmv_per_buyer_gte ≤ 1000000000

last30day_gmv_per_buyer_ltenumberOptional

最近30天客单价 - 最大值

0 ≤ last30day_gmv_per_buyer_lte ≤ 1000000000

last30day_commission_rate_gtenumberOptional

最近30天佣金率 - 最小值

0 ≤ last30day_commission_rate_gte ≤ 100

last30day_commission_rate_ltenumberOptional

最近30天佣金率 - 最大值

0 ≤ last30day_commission_rate_lte ≤ 100

audience_country_code_liststringOptional

受众国家代码，多选逗号分隔

audience_language_code_liststringOptional

受众语言代码，多选逗号分隔

sort_fieldstringOptional

排序字段：followers_cnt, last10_avg_video_views_cnt, last10_avg_video_interaction_rate

Default: "followers_cnt"

sort_orderstringOptional

排序方式 asc/desc

Default: "desc"

asc · desc

pageintegerOptional

页码

Default: 1

1 ≤ page ≤ 200

sizeintegerOptional

每页数量

Default: 50

1 ≤ size ≤ 100

service_levelstringOptional

服务等级：S1（基础）/ S2（精准触达）/ S3（深度画像），默认 S1

crm_filterobjectOptional

私域达人过滤配置

Show fields
enabledbooleanOptional

Default: false

modestringOptional

Default: "exclude"

exclude · include

exclude_cooperatedbooleanOptional

Default: false

exclude_blockedbooleanOptional

Default: false

require_collectedbooleanOptional

Default: true

group_idsarrayOptional
Show fields

Schema details are unavailable for this endpoint.

tagsarrayOptional
Show fields

Schema details are unavailable for this endpoint.

cooperation_statusesarrayOptional
Show fields

Schema details are unavailable for this endpoint.

is_recommendedbooleanOptional
is_focusedbooleanOptional

Response

Schema details are unavailable for this endpoint.