DeveloperDocs.api

creators tiktok search

POST/v1/creators/tiktok/search

DeveloperDocs.authentication: X-API-Key
DeveloperDocs.permission: creator:tiktok:search
DeveloperDocs.billing: DeveloperDocs.configuredBilling
DeveloperDocs.limits: DeveloperDocs.configuredLimits

DeveloperDocs.parameters

DeveloperDocs.jsonBody

keywordstringDeveloperDocs.optional

搜索关键词

union_user_idsarrayDeveloperDocs.optional

达人 union_user_id 列表，最多 200 条

DeveloperDocs.showFields

DeveloperDocs.schemaUnavailable

profile_urlsarrayDeveloperDocs.optional

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

DeveloperDocs.showFields

DeveloperDocs.schemaUnavailable

langstringDeveloperDocs.optional

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

DeveloperDocs.defaultValue: "en"

cn · en

country_codestringDeveloperDocs.optional

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

genderstringDeveloperDocs.optional

性别

has_emailbooleanDeveloperDocs.optional

是否有邮箱

has_mcnbooleanDeveloperDocs.optional

是否绑定MCN

has_linebooleanDeveloperDocs.optional

是否有Line

has_zalobooleanDeveloperDocs.optional

是否有Zalo

language_codestringDeveloperDocs.optional

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

followers_cnt_gteintegerDeveloperDocs.optional

粉丝数 - 最小值

0 ≤ followers_cnt_gte ≤ 1000000000

followers_cnt_lteintegerDeveloperDocs.optional

粉丝数 - 最大值

0 ≤ followers_cnt_lte ≤ 1000000000

last10_avg_video_views_cnt_gtenumberDeveloperDocs.optional

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

0 ≤ last10_avg_video_views_cnt_gte ≤ 1000000000

last10_avg_video_views_cnt_ltenumberDeveloperDocs.optional

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

0 ≤ last10_avg_video_views_cnt_lte ≤ 1000000000

last10_avg_video_interaction_rate_gtenumberDeveloperDocs.optional

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

0 ≤ last10_avg_video_interaction_rate_gte ≤ 100

last10_avg_video_interaction_rate_ltenumberDeveloperDocs.optional

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

0 ≤ last10_avg_video_interaction_rate_lte ≤ 100

last_video_publish_date_gtestringDeveloperDocs.optional

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

last_video_publish_date_ltestringDeveloperDocs.optional

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

product_category_id_arraystringDeveloperDocs.optional

带货类目ID，逗号分隔

industrystringDeveloperDocs.optional

三级英文类目，逗号分隔

audience_female_rate_gtenumberDeveloperDocs.optional

粉丝女性比例 - 最小值

0 ≤ audience_female_rate_gte ≤ 100

audience_female_rate_ltenumberDeveloperDocs.optional

粉丝女性比例 - 最大值

0 ≤ audience_female_rate_lte ≤ 100

audience_age_liststringDeveloperDocs.optional

粉丝主要年龄区间

last30day_gmv_gtenumberDeveloperDocs.optional

最近30天GMV - 最小值

0 ≤ last30day_gmv_gte ≤ 1000000000

last30day_gmv_ltenumberDeveloperDocs.optional

最近30天GMV - 最大值

0 ≤ last30day_gmv_lte ≤ 1000000000

last30day_gpm_gtenumberDeveloperDocs.optional

最近30天GPM - 最小值

0 ≤ last30day_gpm_gte ≤ 1000000000

last30day_gpm_ltenumberDeveloperDocs.optional

最近30天GPM - 最大值

0 ≤ last30day_gpm_lte ≤ 1000000000

last30day_gmv_per_buyer_gtenumberDeveloperDocs.optional

最近30天客单价 - 最小值

0 ≤ last30day_gmv_per_buyer_gte ≤ 1000000000

last30day_gmv_per_buyer_ltenumberDeveloperDocs.optional

最近30天客单价 - 最大值

0 ≤ last30day_gmv_per_buyer_lte ≤ 1000000000

last30day_commission_rate_gtenumberDeveloperDocs.optional

最近30天佣金率 - 最小值

0 ≤ last30day_commission_rate_gte ≤ 100

last30day_commission_rate_ltenumberDeveloperDocs.optional

最近30天佣金率 - 最大值

0 ≤ last30day_commission_rate_lte ≤ 100

audience_country_code_liststringDeveloperDocs.optional

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

audience_language_code_liststringDeveloperDocs.optional

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

sort_fieldstringDeveloperDocs.optional

排序字段：followers_cnt, last10_avg_video_views_cnt, last10_avg_video_interaction_rate

DeveloperDocs.defaultValue: "followers_cnt"

sort_orderstringDeveloperDocs.optional

排序方式 asc/desc

DeveloperDocs.defaultValue: "desc"

asc · desc

pageintegerDeveloperDocs.optional

页码

DeveloperDocs.defaultValue: 1

1 ≤ page ≤ 200

sizeintegerDeveloperDocs.optional

每页数量

DeveloperDocs.defaultValue: 50

1 ≤ size ≤ 100

service_levelstringDeveloperDocs.optional

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

crm_filterobjectDeveloperDocs.optional

私域达人过滤配置

DeveloperDocs.showFields

enabledbooleanDeveloperDocs.optional

DeveloperDocs.defaultValue: false

modestringDeveloperDocs.optional

DeveloperDocs.defaultValue: "exclude"

exclude · include

exclude_cooperatedbooleanDeveloperDocs.optional

DeveloperDocs.defaultValue: false

exclude_blockedbooleanDeveloperDocs.optional

DeveloperDocs.defaultValue: false

require_collectedbooleanDeveloperDocs.optional

DeveloperDocs.defaultValue: true

group_idsarrayDeveloperDocs.optional

DeveloperDocs.showFields

DeveloperDocs.schemaUnavailable

tagsarrayDeveloperDocs.optional

DeveloperDocs.showFields

DeveloperDocs.schemaUnavailable

cooperation_statusesarrayDeveloperDocs.optional

DeveloperDocs.showFields

DeveloperDocs.schemaUnavailable

is_recommendedbooleanDeveloperDocs.optional

is_focusedbooleanDeveloperDocs.optional

DeveloperDocs.response

DeveloperDocs.schemaUnavailable

DeveloperDocs.requestExample

curl -X POST 'https://openapi.creativault.ai/openapi/v1/creators/tiktok/search' \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $CV_API_KEY" \
  --data '{
  "country_code": "US",
  "page": 1,
  "size": 5,
  "service_level": "S1",
  "lang": "en"
}'

DeveloperDocs.exampleNotice

DeveloperDocs.responseExample

{
  "success": true,
  "data": [
    {
      "uid": "example_creator",
      "username": "example_creator",
      "followers_cnt": "15000"
    }
  ],
  "error": null,
  "meta": {
    "request_id": "example_request",
    "page": 1,
    "size": 5,
    "service_level": "S1",
    "credits_consumed": 0,
    "quota_remaining": -1
  }
}

DeveloperDocs.errorHelp →