{"stats":{"calls7d":0,"successRate":null,"avgMs":null,"reviews":0,"usefulRate":null},"id":"p/justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1","kind":"provider","name":"justoneapi_x_douyin-xingtu-gwgsearch-search-for-author-square-v1","description":"Search Xingtu creators by keyword, audience, and pricing. Searches Douyin Creator Marketplace (Xingtu) creators by keyword and structured filters for audience, pricing, content, performance, and campaign fit. (Just One API · Xingtu — Douyin's creator marketplace (influencer rates, audience data))","tags":["douyin-xingtu","advertising","justoneapi","search","creators","data"],"method":"POST","path":"/v1/p/justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1","url":"https://toll402.dev/v1/p/justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1","specUrl":"https://toll402.dev/v1/spec/p/justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1","price":"$0.09225","priceUsd":0.09225,"available":true,"inputSchema":{"type":"object","properties":{"keyword":{"type":"string","description":"Search keyword.","examples":[""]},"page":{"type":"integer","description":"Page number for pagination.","examples":[1]},"sort":{"type":"string","description":"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.","enum":["DEFAULT","FANS"],"examples":["FANS"]},"searchType":{"type":"string","description":"Search criteria type. Available Values: - `NICKNAME`: By Nickname - `CONTENT`: By Content One of: NICKNAME, CONTENT.","enum":["NICKNAME","CONTENT"],"examples":["NICKNAME"]},"marketingTarget":{"type":"string","description":"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 conversio","enum":["BRAND_EXPOSURE","CIRCLE_SEEDING","ACTION_CONVERSION"]},"industry":{"type":"string","description":"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","enum":["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","REAL_ESTATE","EDUCATION_AND_TRAINING","TRAVEL_AND_TOURISM","PUBLIC_SERVICES","GAMES","RETAIL","TRANSPORTATION_EQUIPMENT","AUTOMOTIVE","AGRICULTURE_FORESTRY_FISHERY","CHEMICAL_AND_ENERGY","ELECTRONICS_AND_ELECTRICAL","MACHINERY_EQUIPMENT","MEDIA_AND_INFORMATION","LOGISTICS","TELECOMMUNICATIONS","FINANCIAL_SERVICES","CATERING_SERVICES","SOFTWARE_TOOLS","FRANCHISING_AND_INVESTMENT","BEAUTY_AND_COSMETICS","MOTHER_BABY_AND_PET","DAILY_CHEMICALS","PHYSICAL_BOOKS","SOCIAL_AND_COMMUNICATION","CULTURAL_SUPPLIES","SPORTS_OUTDOOR"],"examples":["ALL"]},"isSuperstar":{"type":"boolean","description":"Whether to filter celebrity creators.","examples":[false]},"followerRange":{"type":"string","description":"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."},"kolPriceType":{"type":"string","description":"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","enum":["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","DOUYIN_SHORT_VIDEO_CO_CREATION_PARTICIPANT"]},"kolPriceRange":{"type":"string","description":"KOL price range (e.g., 10000-50000)."},"contentTag":{"type":"string","description":"Creator category filter. Pass Xingtu first-level or second-level category labels separated by commas. Available values: - 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评"},"contentTheme":{"type":"string","description":"Content theme filter. Pass Xingtu second-level content theme labels separated by commas. Available values include: - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟"},"personaTag":{"type":"string","description":"Creator persona or background labels. Pass Xingtu labels or numeric tag IDs separated by commas. Available values: - 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, "},"gender":{"type":"string","description":"Creator gender. Available values: MALE/1/男性, FEMALE/2/女性. Available Values: - `MALE`: Male - `FEMALE`: Female One of: MALE, FEMALE.","enum":["MALE","FEMALE"]},"location":{"type":"string","description":"Creator location filter. Pass Chinese province or city names separated by commas. Available province values include: 北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, "},"tonalityTag":{"type":"string","description":"Creator tonality labels. Pass Xingtu first-level or second-level tonality labels separated by commas. Available values: - 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, "},"connectedUserRange":{"type":"string","description":"Connected user count range. Pass raw user counts in min-max format. Example: 1000000-3000000"},"audienceImage":{"type":"string","description":"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"},"fansImage":{"type":"string","description":"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"},"expectedPlayRange":{"type":"string","description":"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 1"},"expectedCpmRange":{"type":"string","description":"Expected CPM range in min-max format. Example values matching Xingtu packs: 0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000."},"expectedCpeRange":{"type":"string","description":"Expected CPE range in min-max format. Example values matching Xingtu packs: 0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000."},"interactionRateRange":{"type":"string","description":"Interaction rate range in decimal min-max format. Example values: 0.01-1 for 1% or above, 0.02-1 for 2% or above."},"completionRateRange":{"type":"string","description":"Completion rate range in decimal min-max format. Example values: 0.1-1 for 10% or above, 0.2-1 for 20% or above."},"viralRateRange":{"type":"string","description":"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."},"progressTaskRange":{"type":"string","description":"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-"}},"additionalProperties":true},"example":{"keyword":"","page":1,"sort":"FANS","searchType":"NICKNAME","industry":"ALL","isSuperstar":false},"meta":{"provider":"Just One API","providerSlug":"justoneapi","providerDocs":"https://docs.justoneapi.com/en/usage","providerPricing":"https://www.justoneapi.com/","providerLogo":"https://www.google.com/s2/favicons?domain=justoneapi.com&sz=64","platform":"douyin-xingtu","platformLabel":"Xingtu — Douyin's creator marketplace (influencer rates, audience data)","category":"Advertising","capability":"douyin-xingtu.search.creators","upstreamMethod":"GET","upstreamPriceUsd":0.0738,"pricing":"per_success","pricingNote":"billed only on success (code 0); errors free","verified":"2026-07-28","docs":"https://docs.justoneapi.com/en/api/douyin-creator-marketplace-xingtu/creator-search-v1","calls":0,"successRate":null,"via":"treg"}}