Search Toutiao creators via Xingtu by keyword
tikhub.x.douyin-xingtu-v2-search-toutiao-creatorDouyin: search toutiao creator (xingtu_v2)
- Price
- $0.001/successAt provider cost
- Success rate
- —No success-rate data yetLast 30 days · 3 calls
- Latency p50
- ——
- Last verified
- —Not verified yet
GEThttps://toolswitch.dev/v1/tools/tikhub.x.douyin-xingtu-v2-search-toutiao-creator?tag=1&page=1&gender=2&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&keyword=%E6%95%B0%E7%A0%81&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=11&marketing_target=1&expected_play_max=1000000&expected_play_min=100000&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.1Preview- Uses platform quota
- Synchronous response
- Reads public data
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
tag | other | Optional | Creator category IDs, comma-separated | 1 |
page | integer | Optional | Page number | 1 |
gender | other | Optional | Creator gender, 1=male, 2=female | 2 |
cpe_max | other | Optional | Maximum expected CPE | 5 |
cpe_min | other | Optional | Minimum expected CPE | 0.1 |
cpm_max | other | Optional | Maximum expected CPM | 100 |
cpm_min | other | Optional | Minimum expected CPM | 10 |
keyword | string | Required | Search keyword: nickname, Toutiao ID or content word | 数码 |
fans_max | other | Optional | Maximum followers | 1000000 |
fans_min | other | Optional | Minimum followers | 10000 |
price_max | other | Optional | Maximum creator price | 100000 |
price_min | other | Optional | Minimum creator price | 1000 |
sort_type | integer | Optional | Sort type, 1=asc, 2=desc | 2 |
price_type | other | Optional | Price tier by video length | 2 |
sort_field | string | Optional | Sort field, default score (comprehensive) | score |
extra_filter | other | Optional | 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 | Optional | Persona IDs. Comma=match any, semicolon=group AND | 1129,110401 |
task_category | integer | Optional | Cooperation target | 11 |
author_list_id | other | Optional | Featured creator list ID | |
marketing_target | integer | Optional | Marketing target | 1 |
expected_play_max | other | Optional | Maximum expected plays | 1000000 |
expected_play_min | other | Optional | Minimum expected plays | 100000 |
first_industry_id | other | Optional | Industry ID | |
interact_rate_max | other | Optional | Maximum interaction rate, 0-1 decimal | 0.5 |
interact_rate_min | other | Optional | Minimum interaction rate, 0-1 decimal | 0.02 |
play_over_rate_max | other | Optional | Maximum play-completion rate, 0-1 decimal | 0.9 |
play_over_rate_min | other | Optional | Minimum play-completion rate, 0-1 decimal | 0.05 |
burst_text_rate_max | other | Optional | Maximum viral-post rate, 0-1 decimal | 0.8 |
burst_text_rate_min | other | Optional | Minimum viral-post rate, 0-1 decimal | 0.1 |
- Query parameters
tagotherOptionalCreator category IDs, comma-separated
Example:
1pageintegerOptionalPage number
Example:
1genderotherOptionalCreator gender, 1=male, 2=female
Example:
2cpe_maxotherOptionalMaximum expected CPE
Example:
5cpe_minotherOptionalMinimum expected CPE
Example:
0.1cpm_maxotherOptionalMaximum expected CPM
Example:
100cpm_minotherOptionalMinimum expected CPM
Example:
10keywordstringRequiredSearch keyword: nickname, Toutiao ID or content word
Example:
数码fans_maxotherOptionalMaximum followers
Example:
1000000fans_minotherOptionalMinimum followers
Example:
10000price_maxotherOptionalMaximum creator price
Example:
100000price_minotherOptionalMinimum creator price
Example:
1000sort_typeintegerOptionalSort type, 1=asc, 2=desc
Example:
2price_typeotherOptionalPrice tier by video length
Example:
2sort_fieldstringOptionalSort field, default score (comprehensive)
Example:
scoreextra_filterotherOptionalExtra profile filters (JSON array) for audience/fans profile, region, etc.
Example:
[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]persona_tagsotherOptionalPersona IDs. Comma=match any, semicolon=group AND
Example:
1129,110401task_categoryintegerOptionalCooperation target
Example:
11author_list_idotherOptionalFeatured creator list ID
marketing_targetintegerOptionalMarketing target
Example:
1expected_play_maxotherOptionalMaximum expected plays
Example:
1000000expected_play_minotherOptionalMinimum expected plays
Example:
100000first_industry_idotherOptionalIndustry ID
interact_rate_maxotherOptionalMaximum interaction rate, 0-1 decimal
Example:
0.5interact_rate_minotherOptionalMinimum interaction rate, 0-1 decimal
Example:
0.02play_over_rate_maxotherOptionalMaximum play-completion rate, 0-1 decimal
Example:
0.9play_over_rate_minotherOptionalMinimum play-completion rate, 0-1 decimal
Example:
0.05burst_text_rate_maxotherOptionalMaximum viral-post rate, 0-1 decimal
Example:
0.8burst_text_rate_minotherOptionalMinimum viral-post rate, 0-1 decimal
Example:
0.1
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
curl -X GET 'https://toolswitch.dev/v1/tools/tikhub.x.douyin-xingtu-v2-search-toutiao-creator?tag=1&page=1&gender=2&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&keyword=%E6%95%B0%E7%A0%81&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=11&marketing_target=1&expected_play_max=1000000&expected_play_min=100000&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-toutiao-creator?tag=1&page=1&gender=2&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&keyword=%E6%95%B0%E7%A0%81&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=11&marketing_target=1&expected_play_max=1000000&expected_play_min=100000&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-toutiao-creator?tag=1&page=1&gender=2&cpe_max=5&cpe_min=0.1&cpm_max=100&cpm_min=10&keyword=%E6%95%B0%E7%A0%81&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=11&marketing_target=1&expected_play_max=1000000&expected_play_min=100000&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());This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.001/success, including the service fee.