DeveloperDocs.api

creators twitter search

POST/v1/creators/twitter/search

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

DeveloperDocs.parameters

DeveloperDocs.jsonBody

keywordstringDeveloperDocs.optional

全文检索：search_uname，逗号分隔多关键词 OR

langstringDeveloperDocs.optional

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

DeveloperDocs.defaultValue: "en"

cn · en

country_codestringDeveloperDocs.optional

国家代码，多选逗号分隔

language_codestringDeveloperDocs.optional

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

industrystringDeveloperDocs.optional

三级英文类目，逗号分隔

has_emailbooleanDeveloperDocs.optional

是否有邮箱

has_whatsappbooleanDeveloperDocs.optional

是否有WhatsApp

is_blue_verifiedbooleanDeveloperDocs.optional

是否蓝标认证（Twitter 特有）

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

last10_avg_video_likes_cnt_gtenumberDeveloperDocs.optional

近10条视频平均点赞数 - 最小值

0 ≤ last10_avg_video_likes_cnt_gte ≤ 1000000000

last10_avg_video_likes_cnt_ltenumberDeveloperDocs.optional

近10条视频平均点赞数 - 最大值

0 ≤ last10_avg_video_likes_cnt_lte ≤ 1000000000

last_video_views_cnt_gteintegerDeveloperDocs.optional

最近1条视频观看数 - 最小值

0 ≤ last_video_views_cnt_gte ≤ 1000000000

last_video_views_cnt_lteintegerDeveloperDocs.optional

最近1条视频观看数 - 最大值

0 ≤ last_video_views_cnt_lte ≤ 1000000000

last_video_publish_date_gtestringDeveloperDocs.optional

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

last_video_publish_date_ltestringDeveloperDocs.optional

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

last10_video_views_per_sub_gtenumberDeveloperDocs.optional

均播/粉丝比 - 最小值（百分比）

0 ≤ last10_video_views_per_sub_gte ≤ 100

last10_video_views_per_sub_ltenumberDeveloperDocs.optional

均播/粉丝比 - 最大值（百分比）

0 ≤ last10_video_views_per_sub_lte ≤ 100

last10_med_video_views_per_sub_gtenumberDeveloperDocs.optional

中位播放/粉丝比 - 最小值（百分比）

0 ≤ last10_med_video_views_per_sub_gte ≤ 100

last10_med_video_views_per_sub_ltenumberDeveloperDocs.optional

中位播放/粉丝比 - 最大值（百分比）

0 ≤ last10_med_video_views_per_sub_lte ≤ 100

genderstringDeveloperDocs.optional

性别筛选 → gender_code（'1'=男 '0'=女）（前端暂未启用）

is_verifiedstringDeveloperDocs.optional

是否认证：'1'=已认证, '0'=未认证（前端暂未启用，Twitter 仅用 is_blue_verified）

is_ai_creatorbooleanDeveloperDocs.optional

是否 AI 话题达人（前端暂未启用）

kol_stylestringDeveloperDocs.optional

达人风格标签，多选逗号分隔（前端暂未启用）

audience_country_code_liststringDeveloperDocs.optional

受众国家代码筛选，多选逗号分隔（前端暂未启用）

audience_language_code_liststringDeveloperDocs.optional

受众语言筛选，多选逗号分隔（前端暂未启用）

audience_age_liststringDeveloperDocs.optional

受众年龄筛选，多选逗号分隔（前端暂未启用）

audience_female_rate_gtenumberDeveloperDocs.optional

受众女性占比 - 最小值（百分比）（前端暂未启用）

0 ≤ audience_female_rate_gte ≤ 100

audience_female_rate_ltenumberDeveloperDocs.optional

受众女性占比 - 最大值（百分比）（前端暂未启用）

0 ≤ audience_female_rate_lte ≤ 100

sort_fieldstringDeveloperDocs.optional

排序字段：followers_cnt, last10_avg_video_views_cnt, last10_avg_video_interaction_rate, last10_avg_video_likes_cnt, last_video_views_cnt

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/twitter/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 →