Search Douyin Xingtu creators by keyword and filters
tikhub.x.douyin-xingtu-v2-search-creatorDouyin: search creator (xingtu_v2)
- 价格
- $0.001/success按供应商原价
- 成功率
- 100%近 30 天 · 8 次
- 延迟 p50
- 1.6 秒p95 1.7 秒
- 最后验证
- —尚未验证
GEThttps://toolswitch.dev/v1/tools/tikhub.x.douyin-xingtu-v2-search-creator?tag=1&page=1&gender=2&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&keyword=%E5%81%A5%E8%BA%AB&fans_max=1000000&fans_min=10000&price_max=100000&price_min=1000&sort_type=2&price_type=2&sort_field=score&extra_filter=%5B%7B%22field_name%22%3A%22watcher_gender_female_rate_v2__ge%22%2C%22field_value%22%3A%220.5%22%7D%5D&persona_tags=1129%2C110401&task_category=1&marketing_target=1&expected_play_max=1000000&expected_play_min=100000&first_industry_id=0&interact_rate_max=0.5&interact_rate_min=0.02&play_over_rate_max=0.9&play_over_rate_min=0.05&burst_text_rate_max=0.8&burst_text_rate_min=0.1预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
tag | other | 可选 | Creator category IDs, comma-separated | 1 |
page | 整数 | 可选 | Page number | 1 |
gender | other | 可选 | Creator gender, 1=male, 2=female | 2 |
cpe_max | other | 可选 | Maximum expected CPE | 5 |
cpe_min | other | 可选 | Minimum expected CPE | 0.1 |
cpm_max | other | 可选 | Maximum expected CPM | 100 |
cpm_min | other | 可选 | Minimum expected CPM | 10 |
keyword | 字符串 | 必填 | Search keyword: nickname, Douyin ID, Xingtu ID or content word | 健身 |
fans_max | other | 可选 | Maximum followers | 1000000 |
fans_min | other | 可选 | Minimum followers | 10000 |
price_max | other | 可选 | Maximum creator price | 100000 |
price_min | other | 可选 | Minimum creator price | 1000 |
sort_type | 整数 | 可选 | Sort type, 1=asc, 2=desc | 2 |
price_type | other | 可选 | Price tier by video length | 2 |
sort_field | 字符串 | 可选 | Sort field, default score (comprehensive) | score |
extra_filter | other | 可选 | Extra profile filters (JSON array) for audience/fans profile, region, etc. | [{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}] |
persona_tags | other | 可选 | Persona IDs. Comma=match any, semicolon=group AND | 1129,110401 |
task_category | 整数 | 可选 | Cooperation target | 1 |
author_list_id | other | 可选 | Featured creator list ID | |
marketing_target | 整数 | 可选 | Marketing target | 1 |
expected_play_max | other | 可选 | Maximum expected plays | 1000000 |
expected_play_min | other | 可选 | Minimum expected plays | 100000 |
first_industry_id | 整数 | 可选 | Industry ID, 0=unlimited | 0 |
interact_rate_max | other | 可选 | Maximum interaction rate, 0-1 decimal | 0.5 |
interact_rate_min | other | 可选 | Minimum interaction rate, 0-1 decimal | 0.02 |
play_over_rate_max | other | 可选 | Maximum play-completion rate, 0-1 decimal | 0.9 |
play_over_rate_min | other | 可选 | Minimum play-completion rate, 0-1 decimal | 0.05 |
burst_text_rate_max | other | 可选 | Maximum viral-post rate, 0-1 decimal | 0.8 |
burst_text_rate_min | other | 可选 | Minimum viral-post rate, 0-1 decimal | 0.1 |
- 查询参数
tagother可选Creator category IDs, comma-separated
示例：
1page整数可选Page number
示例：
1genderother可选Creator gender, 1=male, 2=female
示例：
2cpe_maxother可选Maximum expected CPE
示例：
5cpe_minother可选Minimum expected CPE
示例：
0.1cpm_maxother可选Maximum expected CPM
示例：
100cpm_minother可选Minimum expected CPM
示例：
10keyword字符串必填Search keyword: nickname, Douyin ID, Xingtu ID or content word
示例：
健身fans_maxother可选Maximum followers
示例：
1000000fans_minother可选Minimum followers
示例：
10000price_maxother可选Maximum creator price
示例：
100000price_minother可选Minimum creator price
示例：
1000sort_type整数可选Sort type, 1=asc, 2=desc
示例：
2price_typeother可选Price tier by video length
示例：
2sort_field字符串可选Sort field, default score (comprehensive)
示例：
scoreextra_filterother可选Extra profile filters (JSON array) for audience/fans profile, region, etc.
示例：
[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]persona_tagsother可选Persona IDs. Comma=match any, semicolon=group AND
示例：
1129,110401task_category整数可选Cooperation target
示例：
1author_list_idother可选Featured creator list ID
marketing_target整数可选Marketing target
示例：
1expected_play_maxother可选Maximum expected plays
示例：
1000000expected_play_minother可选Minimum expected plays
示例：
100000first_industry_id整数可选Industry ID, 0=unlimited
示例：
0interact_rate_maxother可选Maximum interaction rate, 0-1 decimal
示例：
0.5interact_rate_minother可选Minimum interaction rate, 0-1 decimal
示例：
0.02play_over_rate_maxother可选Maximum play-completion rate, 0-1 decimal
示例：
0.9play_over_rate_minother可选Minimum play-completion rate, 0-1 decimal
示例：
0.05burst_text_rate_maxother可选Maximum viral-post rate, 0-1 decimal
示例：
0.8burst_text_rate_minother可选Minimum viral-post rate, 0-1 decimal
示例：
0.1
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
预览
curl -X GET 'https://toolswitch.dev/v1/tools/tikhub.x.douyin-xingtu-v2-search-creator?tag=1&page=1&gender=2&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&keyword=%E5%81%A5%E8%BA%AB&fans_max=1000000&fans_min=10000&price_max=100000&price_min=1000&sort_type=2&price_type=2&sort_field=score&extra_filter=%5B%7B%22field_name%22%3A%22watcher_gender_female_rate_v2__ge%22%2C%22field_value%22%3A%220.5%22%7D%5D&persona_tags=1129%2C110401&task_category=1&marketing_target=1&expected_play_max=1000000&expected_play_min=100000&first_industry_id=0&interact_rate_max=0.5&interact_rate_min=0.02&play_over_rate_max=0.9&play_over_rate_min=0.05&burst_text_rate_max=0.8&burst_text_rate_min=0.1' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/tikhub.x.douyin-xingtu-v2-search-creator?tag=1&page=1&gender=2&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&keyword=%E5%81%A5%E8%BA%AB&fans_max=1000000&fans_min=10000&price_max=100000&price_min=1000&sort_type=2&price_type=2&sort_field=score&extra_filter=%5B%7B%22field_name%22%3A%22watcher_gender_female_rate_v2__ge%22%2C%22field_value%22%3A%220.5%22%7D%5D&persona_tags=1129%2C110401&task_category=1&marketing_target=1&expected_play_max=1000000&expected_play_min=100000&first_industry_id=0&interact_rate_max=0.5&interact_rate_min=0.02&play_over_rate_max=0.9&play_over_rate_min=0.05&burst_text_rate_max=0.8&burst_text_rate_min=0.1",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/tikhub.x.douyin-xingtu-v2-search-creator?tag=1&page=1&gender=2&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&keyword=%E5%81%A5%E8%BA%AB&fans_max=1000000&fans_min=10000&price_max=100000&price_min=1000&sort_type=2&price_type=2&sort_field=score&extra_filter=%5B%7B%22field_name%22%3A%22watcher_gender_female_rate_v2__ge%22%2C%22field_value%22%3A%220.5%22%7D%5D&persona_tags=1129%2C110401&task_category=1&marketing_target=1&expected_play_max=1000000&expected_play_min=100000&first_industry_id=0&interact_rate_max=0.5&interact_rate_min=0.02&play_over_rate_max=0.9&play_over_rate_min=0.05&burst_text_rate_max=0.8&burst_text_rate_min=0.1", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());网关接口为预览版，地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 $0.001/success 计费，已含服务费。