头条创作者搜索/Search Toutiao Creator
Changed on[中文]
用途:
- 头条创作者搜索(头条图文广场),按关键词搜索今日头条图文创作者,支持完整筛选条件
- 价格:0.002$ / 次
参数:
- keyword: 搜索关键词,可为创作者昵称、头条号或内容词
- page: 页码,默认1
- sort_field: 排序字段,默认score综合排序
- sort_type: 排序方式,1=升序,2=降序,默认2
- 合作诉求: task_category 合作对象、marketing_target 营销目标、first_industry_id 适配行业
- 匹配度: tag 达人类型、persona_tags 达人人设/学历/认证/调性、gender 性别、fans_min/fans_max 粉丝数
- 性价比: expected_play_min/expected_play_max 预期阅读量、 cpm_min/cpm_max 预期CPM、cpe_min/cpe_max 预期CPE、interact_rate_min/interact_rate_max 互动率、 play_over_rate_min/play_over_rate_max 完播率、burst_text_rate_min/burst_text_rate_max 爆文率
- 报价: price_type 固定为 11(头条图文报价);price_min/price_max 为图文报价区间, 提供任一边界时必须同时提供 price_type
- 主题推荐: author_list_id 达人清单ID
- 画像筛选 extra_filter: 观众/粉丝画像、受众画像、所在地域、连接用户数等维度靠它筛选。
传 JSON 数组字符串,每个元素形如 {"field_name":"字段名","field_value":"值"}(可选 rel_id),
常用字段:
- 观众性别: watcher_gender_female_rate_v2__ge(女性占比阈值,取值 0.5/0.6/0.7/0.8), 男性用 watcher_gender_male_rate_v2__ge
- 观众年龄: watcher_age_most_new(观众年龄居多,值为编码数组,如 [22]=24-30岁居多) 示例: extra_filter=[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]
- 说明: tag/persona_tags 的可选ID可通过get_author_market_fields获取;动态画像字段和编码 可通过get_search_field_options获取;比率类参数为0-1小数(0.02=2%)
返回:
- 头条创作者搜索结果数据(含创作者信息、报价、粉丝数、预期阅读量等)
[English]
Purpose:
- Search Toutiao image-text creators in the image-text marketplace by keyword, with full filtering
- Price: 0.002$ / time
Parameters:
- keyword: Search keyword: nickname, Toutiao ID or content word
- page: Page number, default 1
- sort_field: Sort field, default score (comprehensive sort)
- sort_type: Sort type, 1=asc, 2=desc, default 2
- Cooperation: task_category, marketing_target, first_industry_id
- Match: tag (category), persona_tags, gender, fans_min/fans_max
- Cost-performance: expected_play_min/max, cpm_min/max, cpe_min/max, interact_rate_min/max, play_over_rate_min/max, burst_text_rate_min/max
- Price: price_type is fixed to 11 for Toutiao image-text pricing; price_min/price_max define the price range and require price_type when either bound is supplied
- Featured: author_list_id
- Profile filters extra_filter: for audience/fans profile, region, connected-users, etc.
Pass a JSON-array string; each element is {"field_name":"...","field_value":"..."} (optional rel_id),
Common fields:
- Audience gender: watcher_gender_female_rate_v2__ge (female-ratio threshold 0.5/0.6/0.7/0.8), male uses watcher_gender_male_rate_v2__ge
- Audience age: watcher_age_most_new (dominant audience age, encoded array, e.g. [22]=24-30) Example: extra_filter=[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]
- Note: valid IDs for tag/persona_tags come from get_author_market_fields; dynamic profile fields and codes come from get_search_field_options; rate params are 0-1 decimals (0.02=2%)
Return:
- Toutiao creator search result data (creator info, price, followers, expected reads, etc.)
[示例/Example]
keyword = "数码" page = 1 gender = 2 fans_min = 10000
Request
- Base URLhttps://api.tikhub.io (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Query parameters
搜索关键词,可为创作者昵称、头条号或内容词/Search keyword: nickname, Toutiao ID or content word
页码/Page number
排序字段,默认score综合排序/Sort field, default score (comprehensive)
排序方式,1=升序,2=降序/Sort type, 1=asc, 2=desc
合作对象/Cooperation target
营销目标/Marketing target
适配行业ID/Industry ID
主题推荐达人清单ID/Featured creator list ID
头条图文报价类型,固定为11;仅与price_min/price_max配合使用/Toutiao image-text price type, fixed to 11
图文报价下限,提供时必须同时提供price_type/Minimum image-text price
图文报价上限,提供时必须同时提供price_type/Maximum image-text price
达人类型ID,多个用逗号分隔,如1,6/Creator category IDs, comma-separated
达人人设/学历/认证/调性ID。逗号分隔=满足任一;分号分组=每组都要满足,如1129,110401;110213/Persona IDs. Comma=match any, semicolon=group AND
达人性别,1=男,2=女/Creator gender, 1=male, 2=female
粉丝数下限/Minimum followers
粉丝数上限/Maximum followers
预期播放量下限/Minimum expected plays
预期播放量上限/Maximum expected plays
预期CPM下限/Minimum expected CPM
预期CPM上限/Maximum expected CPM
预期CPE下限/Minimum expected CPE
预期CPE上限/Maximum expected CPE
互动率下限,0-1小数,0.02=2%/Minimum interaction rate, 0-1 decimal
互动率上限,0-1小数/Maximum interaction rate, 0-1 decimal
完播率下限,0-1小数/Minimum play-completion rate, 0-1 decimal
完播率上限,0-1小数/Maximum play-completion rate, 0-1 decimal
爆文率下限,0-1小数/Minimum viral-post rate, 0-1 decimal
爆文率上限,0-1小数/Maximum viral-post rate, 0-1 decimal
额外画像筛选的JSON数组字符串,每项必须包含非空字符串field_name和field_value;支持内容主题、观众/粉丝画像、八大人群和地域等维度/Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings
Response
Successful Response
Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
endpoint added
- info