TikHubDouyinSocial

Search Douyin Xingtu creators by keyword and filters

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

Douyin: 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.1

Preview

Try 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
예시: 1
page정수선택
Page number
예시: 1
genderother선택
Creator gender, 1=male, 2=female
예시: 2
cpe_maxother선택
Maximum expected CPE
예시: 5
cpe_minother선택
Minimum expected CPE
예시: 0.1
cpm_maxother선택
Maximum expected CPM
예시: 100
cpm_minother선택
Minimum expected CPM
예시: 10
keyword문자열필수
Search keyword: nickname, Douyin ID, Xingtu ID or content word
예시: 健身
fans_maxother선택
Maximum followers
예시: 1000000
fans_minother선택
Minimum followers
예시: 10000
price_maxother선택
Maximum creator price
예시: 100000
price_minother선택
Minimum creator price
예시: 1000
sort_type정수선택
Sort type, 1=asc, 2=desc
예시: 2
price_typeother선택
Price tier by video length
예시: 2
sort_field문자열선택
Sort field, default score (comprehensive)
예시: score
extra_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,110401
task_category정수선택
Cooperation target
예시: 1
author_list_idother선택
Featured creator list ID
marketing_target정수선택
Marketing target
예시: 1
expected_play_maxother선택
Maximum expected plays
예시: 1000000
expected_play_minother선택
Minimum expected plays
예시: 100000
first_industry_id정수선택
Industry ID, 0=unlimited
예시: 0
interact_rate_maxother선택
Maximum interaction rate, 0-1 decimal
예시: 0.5
interact_rate_minother선택
Minimum interaction rate, 0-1 decimal
예시: 0.02
play_over_rate_maxother선택
Maximum play-completion rate, 0-1 decimal
예시: 0.9
play_over_rate_minother선택
Minimum play-completion rate, 0-1 decimal
예시: 0.05
burst_text_rate_maxother선택
Maximum viral-post rate, 0-1 decimal
예시: 0.8
burst_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이며 서비스 수수료가 포함되어 있습니다.