[中文]

用途:

头条创作者搜索(头条图文广场)，按关键词搜索今日头条图文创作者，支持完整筛选条件

价格：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 粉丝数

性价比: price_type/price_min/price_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 爆文率

主题推荐: 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岁居多)
其它维度(粉丝画像/受众画像/所在地域/连接用户数)的 field_name 与取值，可在达人广场
选中对应筛选后，从其搜索请求(search_for_author_square)的 attribute_filter 中获取。
示例: extra_filter=[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]

说明: tag/persona_tags 的可选ID可通过get_author_market_fields接口获取；比率类参数为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: price_type/price_min/price_max, expected_play_min/max, cpm_min/max,
cpe_min/max, interact_rate_min/max, play_over_rate_min/max, burst_text_rate_min/max

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),
appended as-is to the upstream filter. Verified 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)
For other dimensions (fans profile / region / connected-users), obtain the field_name & value
from the attribute_filter of the search_for_author_square request after selecting that filter
in the creator marketplace.
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; 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

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --globoff 'https://api.tikhub.io/api/v1/douyin/xingtu_v2/search_toutiao_creator?keyword=%E6%95%B0%E7%A0%81&page=1&sort_field=score&sort_type=2&task_category=11&marketing_target=1&first_industry_id=undefined&author_list_id=undefined&tag=1&persona_tags=1129%2C110401&gender=2&fans_min=10000&fans_max=1000000&expected_play_min=100000&expected_play_max=1000000&cpm_min=10&cpm_max=100&cpe_min=0.1&cpe_max=5&interact_rate_min=0.02&interact_rate_max=0.5&play_over_rate_min=0.05&play_over_rate_max=0.9&burst_text_rate_min=0.1&burst_text_rate_max=0.8&price_type=2&price_min=1000&price_max=100000&extra_filter=[{%22field_name%22%3A%22watcher_gender_female_rate_v2__ge%22%2C%22field_value%22%3A%220.5%22}]' \ --header 'Authorization: Bearer <token>'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

头条创作者搜索/Search Toutiao Creator

[中文]

用途:

参数:

返回:

[English]

Purpose:

Parameters:

Return:

[示例/Example]

Request

Responses

头条创作者搜索/Search Toutiao Creator

[中文]#

用途:#

参数:#

返回:#

[English]#

Purpose:#

Parameters:#

Return:#

[示例/Example]#

Request

Responses

[中文]

用途:

参数:

返回:

[English]

Purpose:

Parameters:

Return:

[示例/Example]