`justoneapi_x_douyin-xingtu-gwgsearch-search-for-author-square-v1` $0.09225 per call

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

For AI agents: call justoneapi_x_douyin-xingtu-gwgsearch-search-for-author-square-v1

POST https://toll402.dev/v1/p/justoneapi.x.douyin-xingtu-gwgsearch-search-for-author-square-v1
{
 "keyword": "",
 "page": 1,
 "sort": "FANS",
 "searchType": "NICKNAME",
 "industry": "ALL",
 "isSuperstar": false
}

Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "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
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI

justoneapi_x_douyin-xingtu-gwgsearch-search-for-author-square-v1 $0.09225 per call

Input schema

MCP

`justoneapi_x_douyin-xingtu-gwgsearch-search-for-author-square-v1` $0.09225 per call