Just One APIXingtuAdvertising

Search Xingtu creators by keyword, audience, and pricing

justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1

Searches Douyin Creator Marketplace (Xingtu) creators by keyword and structured filters for audience, pricing, content, performance, and campaign fit.

Price
$0.0738/successプロバイダー原価
Success rate
100%Last 30 days · 7 calls
Latency p50
2.4 sp95 2.9 s
Last verified
2026/07/28Verified 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
Try online近日公開Provider docs ↗
  • Uses platform quota
  • Synchronous response
  • Reads public data

パラメータ

パラメータ型必須説明例
クエリパラメータ
page整数任意Page number for pagination.1
sort文字列任意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文字列任意Creator gender. Available values: MALE/1/男性, FEMALE/2/女性. Available Values: - `MALE`: Male - `FEMALE`: Female One of: MALE, FEMALE.
keyword文字列任意Search keyword.
industry文字列任意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文字列任意Creator location filter. Pass Chinese province or city names separated by commas. Available province values include: 北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别
fansImage文字列任意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文字列任意Creator category filter. Pass Xingtu first-level or second-level category labels separated by commas. Available values: - 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次
personaTag文字列任意Creator persona or background labels. Pass Xingtu labels or numeric tag IDs separated by commas. Available values: - 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白,
searchType文字列任意Search criteria type. Available Values: - `NICKNAME`: By Nickname - `CONTENT`: By Content One of: NICKNAME, CONTENT.NICKNAME
isSuperstar真偽値任意Whether to filter celebrity creators.false
tonalityTag文字列任意Creator tonality labels. Pass Xingtu first-level or second-level tonality labels separated by commas. Available values: - 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球. Example: 精致达人,设计师
contentTheme文字列任意Content theme filter. Pass Xingtu second-level content theme labels separated by commas. Available values include: - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常
kolPriceType文字列任意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文字列任意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文字列任意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文字列任意KOL price range (e.g., 10000-50000).
viralRateRange文字列任意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文字列任意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文字列任意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文字列任意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文字列任意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文字列任意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文字列任意Connected user count range. Pass raw user counts in min-max format. Example: 1000000-3000000
completionRateRange文字列任意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文字列任意Interaction rate range in decimal min-max format. Example values: 0.01-1 for 1% or above, 0.02-1 for 2% or above.
  • クエリパラメータ
  • page整数任意

    Page number for pagination.

    例:1

  • sort文字列任意

    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文字列任意

    Creator gender. Available values: MALE/1/男性, FEMALE/2/女性. Available Values: - `MALE`: Male - `FEMALE`: Female One of: MALE, FEMALE.

  • keyword文字列任意

    Search keyword.

  • industry文字列任意

    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文字列任意

    Creator location filter. Pass Chinese province or city names separated by commas. Available province values include: 北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别

  • fansImage文字列任意

    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文字列任意

    Creator category filter. Pass Xingtu first-level or second-level category labels separated by commas. Available values: - 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次

  • personaTag文字列任意

    Creator persona or background labels. Pass Xingtu labels or numeric tag IDs separated by commas. Available values: - 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白,

  • searchType文字列任意

    Search criteria type. Available Values: - `NICKNAME`: By Nickname - `CONTENT`: By Content One of: NICKNAME, CONTENT.

    例:NICKNAME

  • isSuperstar真偽値任意

    Whether to filter celebrity creators.

    例:false

  • tonalityTag文字列任意

    Creator tonality labels. Pass Xingtu first-level or second-level tonality labels separated by commas. Available values: - 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球. Example: 精致达人,设计师

  • contentTheme文字列任意

    Content theme filter. Pass Xingtu second-level content theme labels separated by commas. Available values include: - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常

  • kolPriceType文字列任意

    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文字列任意

    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文字列任意

    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文字列任意

    KOL price range (e.g., 10000-50000).

  • viralRateRange文字列任意

    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文字列任意

    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文字列任意

    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文字列任意

    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文字列任意

    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文字列任意

    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文字列任意

    Connected user count range. Pass raw user counts in min-max format. Example: 1000000-3000000

  • completionRateRange文字列任意

    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文字列任意

    Interaction rate range in decimal min-max format. Example values: 0.01-1 for 1% or above, 0.02-1 for 2% or above.

コード例

$TOOLSWITCH_KEY をコンソールで作成したキーに置き換えてください。

Preview
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"

このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は $0.0738/success です。サービス料を含みます。