OpenAPI
creators twitter search
/v1/creators/twitter/search- Authentication
- X-API-Key
- Required scope
creator:twitter:search- Billing
- Pricing follows your active account rules
- Rate limits
- View your active rate limits
Parameters
Send this request as a JSON body.
keywordstringOptional全文检索：search_uname，逗号分隔多关键词 OR
langstringOptional响应语言：cn（中文）/ en（英文），默认 en
Default: "en"
cn · en
country_codestringOptional国家代码，多选逗号分隔
language_codestringOptional语言代码筛选，多选逗号分隔，不区分大小写，如 'en,zh'
industrystringOptional三级英文类目，逗号分隔
has_emailbooleanOptional是否有邮箱
has_whatsappbooleanOptional是否有WhatsApp
is_blue_verifiedbooleanOptional是否蓝标认证（Twitter 特有）
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
last10_avg_video_likes_cnt_gtenumberOptional近10条视频平均点赞数 - 最小值
0 ≤ last10_avg_video_likes_cnt_gte ≤ 1000000000
last10_avg_video_likes_cnt_ltenumberOptional近10条视频平均点赞数 - 最大值
0 ≤ last10_avg_video_likes_cnt_lte ≤ 1000000000
last_video_views_cnt_gteintegerOptional最近1条视频观看数 - 最小值
0 ≤ last_video_views_cnt_gte ≤ 1000000000
last_video_views_cnt_lteintegerOptional最近1条视频观看数 - 最大值
0 ≤ last_video_views_cnt_lte ≤ 1000000000
last_video_publish_date_gtestringOptional最近视频发布时间 - 开始日期(YYYY-MM-DD)
last_video_publish_date_ltestringOptional最近视频发布时间 - 结束日期(YYYY-MM-DD)
last10_video_views_per_sub_gtenumberOptional均播/粉丝比 - 最小值（百分比）
0 ≤ last10_video_views_per_sub_gte ≤ 100
last10_video_views_per_sub_ltenumberOptional均播/粉丝比 - 最大值（百分比）
0 ≤ last10_video_views_per_sub_lte ≤ 100
last10_med_video_views_per_sub_gtenumberOptional中位播放/粉丝比 - 最小值（百分比）
0 ≤ last10_med_video_views_per_sub_gte ≤ 100
last10_med_video_views_per_sub_ltenumberOptional中位播放/粉丝比 - 最大值（百分比）
0 ≤ last10_med_video_views_per_sub_lte ≤ 100
genderstringOptional性别筛选 → gender_code（'1'=男 '0'=女）（前端暂未启用）
is_verifiedstringOptional是否认证：'1'=已认证, '0'=未认证（前端暂未启用，Twitter 仅用 is_blue_verified）
is_ai_creatorbooleanOptional是否 AI 话题达人（前端暂未启用）
kol_stylestringOptional达人风格标签，多选逗号分隔（前端暂未启用）
audience_country_code_liststringOptional受众国家代码筛选，多选逗号分隔（前端暂未启用）
audience_language_code_liststringOptional受众语言筛选，多选逗号分隔（前端暂未启用）
audience_age_liststringOptional受众年龄筛选，多选逗号分隔（前端暂未启用）
audience_female_rate_gtenumberOptional受众女性占比 - 最小值（百分比）（前端暂未启用）
0 ≤ audience_female_rate_gte ≤ 100
audience_female_rate_ltenumberOptional受众女性占比 - 最大值（百分比）（前端暂未启用）
0 ≤ audience_female_rate_lte ≤ 100
sort_fieldstringOptional排序字段：followers_cnt, last10_avg_video_views_cnt, last10_avg_video_interaction_rate, last10_avg_video_likes_cnt, last_video_views_cnt
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
enabledbooleanOptionalDefault: false
modestringOptionalDefault: "exclude"
exclude · include
exclude_cooperatedbooleanOptionalDefault: false
exclude_blockedbooleanOptionalDefault: false
require_collectedbooleanOptionalDefault: true
group_idsarrayOptionalShow fields
Schema details are unavailable for this endpoint.
tagsarrayOptionalShow fields
Schema details are unavailable for this endpoint.
cooperation_statusesarrayOptionalShow fields
Schema details are unavailable for this endpoint.
is_recommendedbooleanOptionalis_focusedbooleanOptionalResponse
Schema details are unavailable for this endpoint.