TikHubDouyinSocial

Search Douyin Xingtu creators by keyword and filters

tikhub.x.douyin-xingtu-v2-search-creator

Douyin: search creator (xingtu_v2)

Price: $0.001/successAu prix du fournisseur
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.1

Preview

Try onlineBientôtProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Paramètres

Paramètre	Type	Obligatoire	Description	Exemple
Paramètres de requête
`tag`	other	Facultatif	Creator category IDs, comma-separated	`1`
`page`	entier	Facultatif	Page number	`1`
`gender`	other	Facultatif	Creator gender, 1=male, 2=female	`2`
`cpe_max`	other	Facultatif	Maximum expected CPE	`5`
`cpe_min`	other	Facultatif	Minimum expected CPE	`0.1`
`cpm_max`	other	Facultatif	Maximum expected CPM	`100`
`cpm_min`	other	Facultatif	Minimum expected CPM	`10`
`keyword`	chaîne	Obligatoire	Search keyword: nickname, Douyin ID, Xingtu ID or content word	`健身`
`fans_max`	other	Facultatif	Maximum followers	`1000000`
`fans_min`	other	Facultatif	Minimum followers	`10000`
`price_max`	other	Facultatif	Maximum creator price	`100000`
`price_min`	other	Facultatif	Minimum creator price	`1000`
`sort_type`	entier	Facultatif	Sort type, 1=asc, 2=desc	`2`
`price_type`	other	Facultatif	Price tier by video length	`2`
`sort_field`	chaîne	Facultatif	Sort field, default score (comprehensive)	`score`
`extra_filter`	other	Facultatif	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	Facultatif	Persona IDs. Comma=match any, semicolon=group AND	`1129,110401`
`task_category`	entier	Facultatif	Cooperation target	`1`
`author_list_id`	other	Facultatif	Featured creator list ID
`marketing_target`	entier	Facultatif	Marketing target	`1`
`expected_play_max`	other	Facultatif	Maximum expected plays	`1000000`
`expected_play_min`	other	Facultatif	Minimum expected plays	`100000`
`first_industry_id`	entier	Facultatif	Industry ID, 0=unlimited	`0`
`interact_rate_max`	other	Facultatif	Maximum interaction rate, 0-1 decimal	`0.5`
`interact_rate_min`	other	Facultatif	Minimum interaction rate, 0-1 decimal	`0.02`
`play_over_rate_max`	other	Facultatif	Maximum play-completion rate, 0-1 decimal	`0.9`
`play_over_rate_min`	other	Facultatif	Minimum play-completion rate, 0-1 decimal	`0.05`
`burst_text_rate_max`	other	Facultatif	Maximum viral-post rate, 0-1 decimal	`0.8`
`burst_text_rate_min`	other	Facultatif	Minimum viral-post rate, 0-1 decimal	`0.1`

Paramètres de requête
tagotherFacultatif
Creator category IDs, comma-separated
Exemple : 1
pageentierFacultatif
Page number
Exemple : 1
genderotherFacultatif
Creator gender, 1=male, 2=female
Exemple : 2
cpe_maxotherFacultatif
Maximum expected CPE
Exemple : 5
cpe_minotherFacultatif
Minimum expected CPE
Exemple : 0.1
cpm_maxotherFacultatif
Maximum expected CPM
Exemple : 100
cpm_minotherFacultatif
Minimum expected CPM
Exemple : 10
keywordchaîneObligatoire
Search keyword: nickname, Douyin ID, Xingtu ID or content word
Exemple : 健身
fans_maxotherFacultatif
Maximum followers
Exemple : 1000000
fans_minotherFacultatif
Minimum followers
Exemple : 10000
price_maxotherFacultatif
Maximum creator price
Exemple : 100000
price_minotherFacultatif
Minimum creator price
Exemple : 1000
sort_typeentierFacultatif
Sort type, 1=asc, 2=desc
Exemple : 2
price_typeotherFacultatif
Price tier by video length
Exemple : 2
sort_fieldchaîneFacultatif
Sort field, default score (comprehensive)
Exemple : score
extra_filterotherFacultatif
Extra profile filters (JSON array) for audience/fans profile, region, etc.
Exemple : [{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]
persona_tagsotherFacultatif
Persona IDs. Comma=match any, semicolon=group AND
Exemple : 1129,110401
task_categoryentierFacultatif
Cooperation target
Exemple : 1
author_list_idotherFacultatif
Featured creator list ID
marketing_targetentierFacultatif
Marketing target
Exemple : 1
expected_play_maxotherFacultatif
Maximum expected plays
Exemple : 1000000
expected_play_minotherFacultatif
Minimum expected plays
Exemple : 100000
first_industry_identierFacultatif
Industry ID, 0=unlimited
Exemple : 0
interact_rate_maxotherFacultatif
Maximum interaction rate, 0-1 decimal
Exemple : 0.5
interact_rate_minotherFacultatif
Minimum interaction rate, 0-1 decimal
Exemple : 0.02
play_over_rate_maxotherFacultatif
Maximum play-completion rate, 0-1 decimal
Exemple : 0.9
play_over_rate_minotherFacultatif
Minimum play-completion rate, 0-1 decimal
Exemple : 0.05
burst_text_rate_maxotherFacultatif
Maximum viral-post rate, 0-1 decimal
Exemple : 0.8
burst_text_rate_minotherFacultatif
Minimum viral-post rate, 0-1 decimal
Exemple : 0.1

Exemples de code

Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.

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());

Cette API de passerelle est en préversion ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.001/success, frais de service inclus.