Search Douyin Xingtu creators by keyword and filters
tikhub.x.douyin-xingtu-v2-search-creatorDouyin: search creator (xingtu_v2)
- Price
- $0.001/successプロバイダー原価
- Success rate
- 100%Last 30 days · 8 calls
- Latency p50
- 1.6 sp95 1.7 s
- Last verified
- —Not verified yet
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.1PreviewTry online近日公開Provider docs ↗
- Uses platform quota
- Synchronous response
- Reads public data
パラメータ
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
| クエリパラメータ | ||||
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 をコンソールで作成したキーに置き換えてください。
Preview
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());このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は $0.001/success です。サービス料を含みます。