OpenAPI
搜索 Twitter 达人
搜索 Twitter 达人
/v1/creators/twitter/search- 认证方式
- X-API-Key
- 所需 scope
creator:twitter:search- 计费
- 价格以账户生效规则为准
- 限流
- 查看当前限流规则
请求参数
该请求使用 JSON 请求体提交。
keywordstring可选全文检索：search_uname，逗号分隔多关键词 OR
langstring可选响应语言：cn（中文）/ en（英文），默认 en
默认值: "en"
cn · en
country_codestring可选国家代码，多选逗号分隔
language_codestring可选语言代码筛选，多选逗号分隔，不区分大小写，如 'en,zh'
industrystring可选三级英文类目，逗号分隔
has_emailboolean可选是否有邮箱
has_whatsappboolean可选是否有WhatsApp
is_blue_verifiedboolean可选是否蓝标认证（Twitter 特有）
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
last10_avg_video_likes_cnt_gtenumber可选近10条视频平均点赞数 - 最小值
0 ≤ last10_avg_video_likes_cnt_gte ≤ 1000000000
last10_avg_video_likes_cnt_ltenumber可选近10条视频平均点赞数 - 最大值
0 ≤ last10_avg_video_likes_cnt_lte ≤ 1000000000
last_video_views_cnt_gteinteger可选最近1条视频观看数 - 最小值
0 ≤ last_video_views_cnt_gte ≤ 1000000000
last_video_views_cnt_lteinteger可选最近1条视频观看数 - 最大值
0 ≤ last_video_views_cnt_lte ≤ 1000000000
last_video_publish_date_gtestring可选最近视频发布时间 - 开始日期(YYYY-MM-DD)
last_video_publish_date_ltestring可选最近视频发布时间 - 结束日期(YYYY-MM-DD)
last10_video_views_per_sub_gtenumber可选均播/粉丝比 - 最小值（百分比）
0 ≤ last10_video_views_per_sub_gte ≤ 100
last10_video_views_per_sub_ltenumber可选均播/粉丝比 - 最大值（百分比）
0 ≤ last10_video_views_per_sub_lte ≤ 100
last10_med_video_views_per_sub_gtenumber可选中位播放/粉丝比 - 最小值（百分比）
0 ≤ last10_med_video_views_per_sub_gte ≤ 100
last10_med_video_views_per_sub_ltenumber可选中位播放/粉丝比 - 最大值（百分比）
0 ≤ last10_med_video_views_per_sub_lte ≤ 100
genderstring可选性别筛选 → gender_code（'1'=男 '0'=女）（前端暂未启用）
is_verifiedstring可选是否认证：'1'=已认证, '0'=未认证（前端暂未启用，Twitter 仅用 is_blue_verified）
is_ai_creatorboolean可选是否 AI 话题达人（前端暂未启用）
kol_stylestring可选达人风格标签，多选逗号分隔（前端暂未启用）
audience_country_code_liststring可选受众国家代码筛选，多选逗号分隔（前端暂未启用）
audience_language_code_liststring可选受众语言筛选，多选逗号分隔（前端暂未启用）
audience_age_liststring可选受众年龄筛选，多选逗号分隔（前端暂未启用）
audience_female_rate_gtenumber可选受众女性占比 - 最小值（百分比）（前端暂未启用）
0 ≤ audience_female_rate_gte ≤ 100
audience_female_rate_ltenumber可选受众女性占比 - 最大值（百分比）（前端暂未启用）
0 ≤ audience_female_rate_lte ≤ 100
sort_fieldstring可选排序字段：followers_cnt, last10_avg_video_views_cnt, last10_avg_video_interaction_rate, last10_avg_video_likes_cnt, last_video_views_cnt
默认值: "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 详情。