Search Xingtu creators by keyword, audience, and pricing
justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1Searches Douyin Creator Marketplace (Xingtu) creators by keyword and structured filters for audience, pricing, content, performance, and campaign fit.
- Price
- $0.0738/successPelo preço do provedor
- Success rate
- 100%Last 30 days · 7 calls
- Latency p50
- 2.4 sp95 2.9 s
- Last verified
- 28 de jul. de 2026Verified working
GEThttps://toolswitch.dev/v1/tools/justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1?page=1&sort=FANS&keyword=coffee&industry=ALL&searchType=NICKNAME&isSuperstar=FalsePreview- Uses platform quota
- Synchronous response
- Reads public data
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| Parâmetros de consulta | ||||
page | inteiro | Opcional | Page number for pagination. | 1 |
sort | string | Opcional | Creator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Xingtu score ranking. Available Values: - `DEFAULT`: Platform default score ranking - `FANS`: Sort by follower count descending One of: DEFAULT, FANS. | FANS |
gender | string | Opcional | Creator gender. Available values: MALE/1/男性, FEMALE/2/女性. Available Values: - `MALE`: Male - `FEMALE`: Female One of: MALE, FEMALE. | |
keyword | string | Opcional | Search keyword. | |
industry | string | Opcional | Recommended industry filter. Pass enum name, numeric industry ID, or Chinese industry label. Available values: - ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936: 医疗机构; - 1909: 家居建材; - 1907: 生活服务; - 1906: 商务服务; - 1921: 休闲娱乐; - 1937: 丽人; - 1908: 房地产; - 1910: 教育培训; One of: ALL, ELECTRONICS_AND_APPLIANCES, SHOPPING, FOOD_AND_BEVERAGE, CLOTHING_AND_ACCESSORIES, HEALTHCARE_AND_MEDICAL, MEDICAL_INSTITUTIONS, HOME_AND_BUILDING_MATERIALS, LOCAL_SERVICES, BUSINESS_SERVICES, CULTURE_SPORTS_ENTERTAINMENT, BEAUTY_SERVICES. | ALL |
location | string | Opcional | Creator location filter. Pass Chinese province or city names separated by commas. Available province values include: 北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别 | |
fansImage | string | Opcional | Fan profile filter from Xingtu Fan Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, AGE_31_40, | |
contentTag | string | Opcional | Creator category filter. Pass Xingtu first-level or second-level category labels separated by commas. Available values: - 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次 | |
personaTag | string | Opcional | Creator persona or background labels. Pass Xingtu labels or numeric tag IDs separated by commas. Available values: - 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白, | |
searchType | string | Opcional | Search criteria type. Available Values: - `NICKNAME`: By Nickname - `CONTENT`: By Content One of: NICKNAME, CONTENT. | NICKNAME |
isSuperstar | booleano | Opcional | Whether to filter celebrity creators. | false |
tonalityTag | string | Opcional | Creator tonality labels. Pass Xingtu first-level or second-level tonality labels separated by commas. Available values: - 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球. Example: 精致达人,设计师 | |
contentTheme | string | Opcional | Content theme filter. Pass Xingtu second-level content theme labels separated by commas. Available values include: - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常 | |
kolPriceType | string | Opcional | KOL price type. Available Values: - `VIDEO_1_20S`: Video 1-20s - `VIDEO_21_60S`: Video 21-60s - `VIDEO_OVER_60S`: Video > 60s - `CUSTOM_SHORT_DRAMA_EPISODE`: Mini-drama episode - `NATURAL_PLAY_CPM`: CPM naturally - `SHORT_LIVE_SEEDING_VIDEO`: Short-live seeding video - `SHORT_LIVE_WARMUP_VIDEO`: Sho One of: VIDEO_1_20S, VIDEO_21_60S, VIDEO_OVER_60S, CUSTOM_SHORT_DRAMA_EPISODE, NATURAL_PLAY_CPM, SHORT_LIVE_SEEDING_VIDEO, SHORT_LIVE_WARMUP_VIDEO, CELEBRITY_SHORT_LIVE_SEEDING, CELEBRITY_SHORT_LIVE_WARMUP, CELEBRITY_VIDEO, COLLECTION_VIDEO, DOUYIN_SHORT_VIDEO_CO_CREATION_MAIN_CREATOR. | |
audienceImage | string | Opcional | Audience profile filter from Xingtu Audience Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, A | |
followerRange | string | Opcional | Raw follower count range in min-max format. Example: 1000-2000 means 1,000 to 2,000 followers; 5000000-10000000 means 5 million to 10 million followers. | |
kolPriceRange | string | Opcional | KOL price range (e.g., 10000-50000). | |
viralRateRange | string | Opcional | Viral content rate range in decimal min-max format. Page presets include 0-0.1, 0.1-0.25, 0.25-0.5, 0.5-0.99, and 0.99 or above. For open-ended presets, pass a high upper bound such as 0.99-1. Example: 0.1-0.25. | |
marketingTarget | string | Opcional | Marketing goal. Available values: BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化. Available Values: - `BRAND_EXPOSURE`: Brand exposure - `CIRCLE_SEEDING`: Out-of-circle seeding - `ACTION_CONVERSION`: Action conversion One of: BRAND_EXPOSURE, CIRCLE_SEEDING, ACTION_CONVERSION. | |
expectedCpeRange | string | Opcional | Expected CPE range in min-max format. Example values matching Xingtu packs: 0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000. | |
expectedCpmRange | string | Opcional | Expected CPM range in min-max format. Example values matching Xingtu packs: 0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000. | |
expectedPlayRange | string | Opcional | Expected play count range. Use raw counts in min-max format. Page presets include 10000000 or above, 5000000-10000000, 3000000-5000000, 1000000-3000000, 100000-1000000, and 0-100000. For open-ended presets, pass a high upper bound such as 10000000-1000000000. Example: 1000000-3000000. | |
progressTaskRange | string | Opcional | In-progress task count range. Place a colon between the day count and the min-max range; omit either bound for an open range. Example: 30:8- | |
connectedUserRange | string | Opcional | Connected user count range. Pass raw user counts in min-max format. Example: 1000000-3000000 | |
completionRateRange | string | Opcional | Completion rate range in decimal min-max format. Example values: 0.1-1 for 10% or above, 0.2-1 for 20% or above. | |
interactionRateRange | string | Opcional | Interaction rate range in decimal min-max format. Example values: 0.01-1 for 1% or above, 0.02-1 for 2% or above. | |
- Parâmetros de consulta
pageinteiroOpcionalPage number for pagination.
Exemplo:
1sortstringOpcionalCreator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Xingtu score ranking. Available Values: - `DEFAULT`: Platform default score ranking - `FANS`: Sort by follower count descending One of: DEFAULT, FANS.
Exemplo:
FANSgenderstringOpcionalCreator gender. Available values: MALE/1/男性, FEMALE/2/女性. Available Values: - `MALE`: Male - `FEMALE`: Female One of: MALE, FEMALE.
keywordstringOpcionalSearch keyword.
industrystringOpcionalRecommended industry filter. Pass enum name, numeric industry ID, or Chinese industry label. Available values: - ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936: 医疗机构; - 1909: 家居建材; - 1907: 生活服务; - 1906: 商务服务; - 1921: 休闲娱乐; - 1937: 丽人; - 1908: 房地产; - 1910: 教育培训; One of: ALL, ELECTRONICS_AND_APPLIANCES, SHOPPING, FOOD_AND_BEVERAGE, CLOTHING_AND_ACCESSORIES, HEALTHCARE_AND_MEDICAL, MEDICAL_INSTITUTIONS, HOME_AND_BUILDING_MATERIALS, LOCAL_SERVICES, BUSINESS_SERVICES, CULTURE_SPORTS_ENTERTAINMENT, BEAUTY_SERVICES.
Exemplo:
ALLlocationstringOpcionalCreator location filter. Pass Chinese province or city names separated by commas. Available province values include: 北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别
fansImagestringOpcionalFan profile filter from Xingtu Fan Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, AGE_31_40,
contentTagstringOpcionalCreator category filter. Pass Xingtu first-level or second-level category labels separated by commas. Available values: - 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次
personaTagstringOpcionalCreator persona or background labels. Pass Xingtu labels or numeric tag IDs separated by commas. Available values: - 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白,
searchTypestringOpcionalSearch criteria type. Available Values: - `NICKNAME`: By Nickname - `CONTENT`: By Content One of: NICKNAME, CONTENT.
Exemplo:
NICKNAMEisSuperstarbooleanoOpcionalWhether to filter celebrity creators.
Exemplo:
falsetonalityTagstringOpcionalCreator tonality labels. Pass Xingtu first-level or second-level tonality labels separated by commas. Available values: - 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球. Example: 精致达人,设计师
contentThemestringOpcionalContent theme filter. Pass Xingtu second-level content theme labels separated by commas. Available values include: - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常
kolPriceTypestringOpcionalKOL price type. Available Values: - `VIDEO_1_20S`: Video 1-20s - `VIDEO_21_60S`: Video 21-60s - `VIDEO_OVER_60S`: Video > 60s - `CUSTOM_SHORT_DRAMA_EPISODE`: Mini-drama episode - `NATURAL_PLAY_CPM`: CPM naturally - `SHORT_LIVE_SEEDING_VIDEO`: Short-live seeding video - `SHORT_LIVE_WARMUP_VIDEO`: Sho One of: VIDEO_1_20S, VIDEO_21_60S, VIDEO_OVER_60S, CUSTOM_SHORT_DRAMA_EPISODE, NATURAL_PLAY_CPM, SHORT_LIVE_SEEDING_VIDEO, SHORT_LIVE_WARMUP_VIDEO, CELEBRITY_SHORT_LIVE_SEEDING, CELEBRITY_SHORT_LIVE_WARMUP, CELEBRITY_VIDEO, COLLECTION_VIDEO, DOUYIN_SHORT_VIDEO_CO_CREATION_MAIN_CREATOR.
audienceImagestringOpcionalAudience profile filter from Xingtu Audience Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, A
followerRangestringOpcionalRaw follower count range in min-max format. Example: 1000-2000 means 1,000 to 2,000 followers; 5000000-10000000 means 5 million to 10 million followers.
kolPriceRangestringOpcionalKOL price range (e.g., 10000-50000).
viralRateRangestringOpcionalViral content rate range in decimal min-max format. Page presets include 0-0.1, 0.1-0.25, 0.25-0.5, 0.5-0.99, and 0.99 or above. For open-ended presets, pass a high upper bound such as 0.99-1. Example: 0.1-0.25.
marketingTargetstringOpcionalMarketing goal. Available values: BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化. Available Values: - `BRAND_EXPOSURE`: Brand exposure - `CIRCLE_SEEDING`: Out-of-circle seeding - `ACTION_CONVERSION`: Action conversion One of: BRAND_EXPOSURE, CIRCLE_SEEDING, ACTION_CONVERSION.
expectedCpeRangestringOpcionalExpected CPE range in min-max format. Example values matching Xingtu packs: 0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000.
expectedCpmRangestringOpcionalExpected CPM range in min-max format. Example values matching Xingtu packs: 0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000.
expectedPlayRangestringOpcionalExpected play count range. Use raw counts in min-max format. Page presets include 10000000 or above, 5000000-10000000, 3000000-5000000, 1000000-3000000, 100000-1000000, and 0-100000. For open-ended presets, pass a high upper bound such as 10000000-1000000000. Example: 1000000-3000000.
progressTaskRangestringOpcionalIn-progress task count range. Place a colon between the day count and the min-max range; omit either bound for an open range. Example: 30:8-
connectedUserRangestringOpcionalConnected user count range. Pass raw user counts in min-max format. Example: 1000000-3000000
completionRateRangestringOpcionalCompletion rate range in decimal min-max format. Example values: 0.1-1 for 10% or above, 0.2-1 for 20% or above.
interactionRateRangestringOpcionalInteraction rate range in decimal min-max format. Example values: 0.01-1 for 1% or above, 0.02-1 for 2% or above.
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
curl -X GET 'https://toolswitch.dev/v1/tools/justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1?page=1&sort=FANS&keyword=coffee&industry=ALL&searchType=NICKNAME&isSuperstar=False' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1?page=1&sort=FANS&keyword=coffee&industry=ALL&searchType=NICKNAME&isSuperstar=False",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1?page=1&sort=FANS&keyword=coffee&industry=ALL&searchType=NICKNAME&isSuperstar=False", {
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());Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.0738/success, incluindo a taxa de serviço.