---
title: "抖音巨量星图创作者搜索 API (V1)"
description: "通过关键词和结构化筛选（包括受众、定价、内容、表现和活动匹配度）搜索抖音巨量星图创作者。用于构建和比较活动候选名单。"
aiUsagePrompt: true
---

# 抖音巨量星图创作者搜索 API \(V1\)

<ApiTester
  method="GET"
  :path='JSON.parse("\"/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1\"")'
  :summary='JSON.parse("\"创作者搜索 (V1)\"")'
  openapiDefinitionUrl="https://docs.justoneapi.com/openapi/douyin-creator-marketplace-xingtu/creator-search-v1-zh.json"
  openapiVersion="3.1.0"
  :parameters='JSON.parse("[{\"name\":\"token\",\"in\":\"query\",\"description\":\"用户鉴权令牌。\",\"required\":true,\"schema\":{\"type\":\"string\"}},{\"name\":\"keyword\",\"in\":\"query\",\"description\":\"搜索关键词。\",\"required\":false,\"schema\":{\"type\":\"string\",\"default\":\"\"}},{\"name\":\"page\",\"in\":\"query\",\"description\":\"用于分页的页码。\",\"required\":false,\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"name\":\"sort\",\"in\":\"query\",\"description\":\"创作者搜索排序。可选值：FANS 按粉丝数降序排序，DEFAULT 使用星图评分排序。\\n\\n可选值：\\n- `DEFAULT`：平台默认评分排序\\n- `FANS`：按粉丝数降序排序\",\"required\":false,\"schema\":{\"type\":\"string\",\"default\":\"FANS\",\"description\":\"创作者搜索排序。\",\"enum\":[\"DEFAULT\",\"FANS\"]}},{\"name\":\"searchType\",\"in\":\"query\",\"description\":\"搜索条件类型。\\n\\n可用值：\\n- `NICKNAME`: 按昵称\\n- `CONTENT`: 按内容\",\"required\":false,\"schema\":{\"type\":\"string\",\"default\":\"NICKNAME\",\"description\":\"搜索条件类型。\",\"enum\":[\"NICKNAME\",\"CONTENT\"]}},{\"name\":\"marketingTarget\",\"in\":\"query\",\"description\":\"营销目标。可选值：BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化。\\n\\n可选值：\\n- `BRAND_EXPOSURE`: 品牌曝光\\n- `CIRCLE_SEEDING`: 破圈种草\\n- `ACTION_CONVERSION`: 行动转化\",\"required\":false,\"schema\":{\"type\":\"string\",\"description\":\"营销目标。\",\"enum\":[\"BRAND_EXPOSURE\",\"CIRCLE_SEEDING\",\"ACTION_CONVERSION\"]}},{\"name\":\"industry\",\"in\":\"query\",\"description\":\"推荐行业筛选。传入枚举名称、数字行业ID或中文行业标签。可用值：- ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936: 医疗机构; - 1909: 家居建材; - 1907: 生活服务; - 1906: 商务服务; - 1921: 休闲娱乐; - 1937: 丽人; - 1908: 房地产; - 1910: 教育培训; - 1911: 出行旅游; - 1912: 社会公共; - 1913: 游戏; - 1914: 互联网电商服务; - 1915: 交通工具; - 1916: 汽车; - 1917: 农资园艺; - 1920: 机械设备; - 1939: 文化用品; - 1940: 运动户外; - 1922: 传媒资讯; - 1924: 通信; - 1925: 金融业; - 1927: 餐饮服务; - 1928: 工具类软件; - 1929: 招商加盟; - 1930: 美妆; - 1931: 母婴宠物; - 1933: 日化; - 1934: 实体书籍; - 1935: 社交通讯.\\n\\n可用值：\\n- `ALL`：全部\\n- `ELECTRONICS_AND_APPLIANCES`：3C及电器\\n- `SHOPPING`：购物\\n- `FOOD_AND_BEVERAGE`：食品饮料\\n- `CLOTHING_AND_ACCESSORIES`：服装配饰\\n- `HEALTHCARE_AND_MEDICAL`：医药健康\\n- `MEDICAL_INSTITUTIONS`：医疗机构\\n- `HOME_AND_BUILDING_MATERIALS`：家居建材\\n- `LOCAL_SERVICES`：生活服务\\n- `BUSINESS_SERVICES`：商务服务\\n- `CULTURE_SPORTS_ENTERTAINMENT`：休闲娱乐\\n- `BEAUTY_SERVICES`：丽人\\n- `REAL_ESTATE`：房地产\\n- `EDUCATION_AND_TRAINING`：教育培训\\n- `TRAVEL_AND_TOURISM`：出行旅游\\n- `PUBLIC_SERVICES`：社会公共\\n- `GAMES`：游戏\\n- `RETAIL`：互联网电商服务\\n- `TRANSPORTATION_EQUIPMENT`：交通工具\\n- `AUTOMOTIVE`：汽车\\n- `AGRICULTURE_FORESTRY_FISHERY`：农资园艺\\n- `CHEMICAL_AND_ENERGY`：化工能源\\n- `ELECTRONICS_AND_ELECTRICAL`：电子电气\\n- `MACHINERY_EQUIPMENT`：机械设备\\n- `MEDIA_AND_INFORMATION`：传媒资讯\\n- `LOGISTICS`：物流仓储\\n- `TELECOMMUNICATIONS`：通信\\n- `FINANCIAL_SERVICES`：金融业\\n- `CATERING_SERVICES`：餐饮服务\\n- `SOFTWARE_TOOLS`：工具类软件\\n- `FRANCHISING_AND_INVESTMENT`：招商加盟\\n- `BEAUTY_AND_COSMETICS`：美妆\\n- `MOTHER_BABY_AND_PET`：母婴宠物\\n- `DAILY_CHEMICALS`：日化\\n- `PHYSICAL_BOOKS`：实体书籍\\n- `SOCIAL_AND_COMMUNICATION`：社交通讯\\n- `CULTURAL_SUPPLIES`：文化用品\\n- `SPORTS_OUTDOOR`：运动户外\",\"required\":false,\"schema\":{\"type\":\"string\",\"default\":\"ALL\",\"description\":\"行业分类。\",\"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\"]}},{\"name\":\"isSuperstar\",\"in\":\"query\",\"description\":\"是否筛选达人创作者。\",\"required\":false,\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"name\":\"followerRange\",\"in\":\"query\",\"description\":\"原始粉丝数量范围，格式为最小值-最大值。例如：1000-2000表示1000到2000个粉丝；5000000-10000000表示500万到1000万个粉丝。\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"kolPriceType\",\"in\":\"query\",\"description\":\"当前巨量星图市场选项中的创作者报价类型。\\n\\n可用值：\\n- `PRODUCT_PLACEMENT_VIDEO`: 产品植入视频\\n- `CUSTOM_VIDEO`: 定制视频\\n- `CUSTOM_SHORT_DRAMA_EPISODE`: 迷你剧集\\n- `NATURAL_PLAY_CPM`: 自然播放 CPM\\n- `SHORT_LIVE_SEEDING_VIDEO`: 短直种草视频\\n- `SHORT_LIVE_WARMUP_VIDEO`: 短直预热视频\\n- `CELEBRITY_SHORT_LIVE_SEEDING`: 达人短直种草\\n- `CELEBRITY_SHORT_LIVE_WARMUP`: 达人短直预热\\n- `CELEBRITY_VIDEO`: 达人视频\\n- `COLLECTION_VIDEO`: 合集视频\\n- `DOUYIN_SHORT_VIDEO_CO_CREATION_MAIN_CREATOR`: 抖音短视频共创 - 主创作者\\n- `DOUYIN_SHORT_VIDEO_CO_CREATION_PARTICIPANT`: 抖音短视频共创 - 参与者\",\"required\":false,\"schema\":{\"type\":\"string\",\"description\":\"KOL价格类型。\",\"enum\":[\"PRODUCT_PLACEMENT_VIDEO\",\"CUSTOM_VIDEO\",\"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\"]}},{\"name\":\"kolPriceRange\",\"in\":\"query\",\"description\":\"创作者报价范围，采用最小-最大格式（例如：10000-50000）。需要 kolPriceType；省略 kolPriceRange 以使用所选报价类型的完整范围。\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"contentTag\",\"in\":\"query\",\"description\":\"创作者分类筛选。传入星图一级或二级分类标签，多个用逗号分隔。可选值：- 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次元: 二次元真人, 动画漫画, 配音声优, 宅物手办; - 旅行: 旅行记录, 旅行攻略, 旅行推荐, 户外生活; - 汽车: 汽车测评, 汽车知识, 汽车周边; - 生活: 生活记录, 生活小窍门, 好物推荐, 健康养生, 婚恋; - 音乐: 歌曲演唱, 乐器演奏, 音乐教学, 音乐其他, 音乐剪辑; - 舞蹈; - 美食: 美食教程, 美食探店, 美食产品测评, 乡村野食, 美食其他, 酒类; - 母婴亲子: 育儿科普, 萌娃日常, 亲子互动, 测评种草; - 运动健身: 健身, 极限运动, 体育资讯, 冰雪, 垂钓, 格斗, 球类项目, 综合体育; - 科技数码: 3C数码, 家居电器, 科技; - 教育培训: 考学培训, 语言教学, 个人管理, 职业教育; - 颜值达人: 美女, 帅哥; - 生活家居: 硬装, 软装, 生活技巧, 家居氛围; - 才艺技能: 创意才能, 手工, 摄影, 绘画, 其他才艺; - 影视娱乐: 影视解说, 影视混剪, 明星资讯, 综艺解说, 综艺混剪; - 艺术文化: 传统文化, 人文科普, 自然科学; - 财经投资: 传统金融, 互联网金融, 财经知识; - 三农; - 剧情搞笑: 剧情, 搞笑; - 情感; - 园艺; - 房产: 其他房产, 房产知识, 房产及投资, 楼盘评测, 楼市资讯, 租房; - 随拍; - 媒体号。示例：美妆,穿搭,剧情搞笑\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"contentTheme\",\"in\":\"query\",\"description\":\"内容主题过滤。传入星图二级内容主题标签，用逗号分隔。仅接受冒号后列出的标签；冒号前的类别标题仅为描述性内容，不可传入。可用值包括： - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常菜谱, 美食探店, 零食测评, 酒水品鉴, 厨房用品, 海鲜烹饪, 减脂美食; - 精彩车生活: 汽车行业资讯, 用车知识, 车辆保养, 自驾旅行, 新能源汽车资讯, 汽车用品测评, SUV测评; - 手机/数码/家电分享: 科技科普, 电子产品测评, 家电推荐, 手机评测, 智能家居, AI应用, 数码开箱; - 剧情演绎: 搞笑剧情, 剧情反转, 情感演绎, 家庭幽默演绎, 职场趣闻, 古风剧情, 生存挑战; - 萌宠养护: 宠物狗故事, 动物萌态, 宠物养护, 猫咪萌态, 宠物健康, 宠物护理, 宠物救助; - 旅行攻略: 国内旅行, 海外旅行, 城市旅行攻略, 酒店体验, 露营体验, 亲子旅行, 网红景点种草; - 家居好物: 清洁技巧, 生活好物评测, 家居选购, 家居装修, 家居收纳, 家装避坑, 房间布置; - 运动户外: 户外运动, 健身塑形, 赛事回顾, 体重管理, 极限运动, 跑步健身, 户外露营. 示例：亲子活动,宝宝辅食\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"personaTag\",\"in\":\"query\",\"description\":\"创作者人设或背景标签。传入星图标签或数字标签ID，多个用逗号分隔。可选值：- 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白, 抗老, 祛皱, 抗炎, 修复, 控油, 眼部护理, 补水保湿, 祛斑, 祛痘祛闭口, 隔离防晒; - 母婴阶段: 孕期, 0-6月, 7-12月, 1-3岁, 3-6岁, 6-12岁, 12-15岁, 15-18岁; - 爱好: 摄影, 时尚穿搭, 美食制作, 科普, 星座, 绘画; - 职业: 法律从业者, 航空业从业者, 健身/舞蹈教练, 专业美食从业者, 室内设计师; - 学历: 大学生, 硕士生, 博士, 留学生; - 黄v认证: 美妆创作者, 体育创作者, 媒体人/主持人, 科技创作者, 运动员; - 其他标签: 潮流运动, 球类, 非球类, 室内健身, 城市运动, 户外运动, 数码潮流玩家, 户外爱好者, 室内设计师, 品酒家/调酒师, 美食评论人, 母婴行业专家, 奶爸, 旧屋改造, 装修设计, 收纳, 新生儿妈妈, 孕妈, 时尚妈妈, 二三胎妈妈, 西餐, 火锅, 国风爱好者, 成分党。示例：大学生,美妆创作者\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"gender\",\"in\":\"query\",\"description\":\"创作者性别。可选值：MALE/1/男性, FEMALE/2/女性。\\n\\n可选值：\\n- `MALE`: 男性\\n- `FEMALE`: 女性\",\"required\":false,\"schema\":{\"type\":\"string\",\"description\":\"创作者性别。\",\"enum\":[\"MALE\",\"FEMALE\"]}},{\"name\":\"location\",\"in\":\"query\",\"description\":\"创作者地域筛选。传入中国省份或城市名称，多个用逗号分隔。可选省份值包括：北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别行政区, 澳门特别行政区。示例：广东省,深圳市\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"tonalityTag\",\"in\":\"query\",\"description\":\"创作者调性标签。传入星图一级或二级调性标签，多个用逗号分隔。可选值：- 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球。示例：精致达人,设计师\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"connectedUserRange\",\"in\":\"query\",\"description\":\"关联用户数范围。传入原始用户数，格式为最小值-最大值。示例：1000000-3000000\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"audienceImage\",\"in\":\"query\",\"description\":\"受众画像筛选条件, 来自星图受众画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: 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_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - 设备: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - 城市等级: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - 平均订单金额: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - 人群画像: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). 括号中的数字 ID 和中文标签仅供参考, 不作为输入值. 示例: GENDER_FEMALE_50,CROWD_REFINED_MOTHER\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"fansImage\",\"in\":\"query\",\"description\":\"粉丝画像筛选条件, 来自星图粉丝画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: 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_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - 设备: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - 城市等级: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - 平均订单金额: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - 人群画像: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). 括号中的数字 ID 和中文标签仅供参考, 不作为输入值. 示例: GENDER_FEMALE_50,CROWD_REFINED_MOTHER\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"expectedPlayRange\",\"in\":\"query\",\"description\":\"预期播放量范围。使用原始播放量，格式为最小值-最大值。页面预设包括10000000及以上、5000000-10000000、3000000-5000000、1000000-3000000、100000-1000000、0-100000。对于开放式预设，传入一个较大的上限，如10000000-1000000000。示例：1000000-3000000。\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"expectedCpmRange\",\"in\":\"query\",\"description\":\"预期CPM范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000。\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"expectedCpeRange\",\"in\":\"query\",\"description\":\"预期CPE范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000。\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"interactionRateRange\",\"in\":\"query\",\"description\":\"互动率范围，格式为小数最小值-最大值。示例值：0.01-1表示1%及以上，0.02-1表示2%及以上。\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"completionRateRange\",\"in\":\"query\",\"description\":\"完播率范围，格式为小数最小值-最大值。示例值：0.1-1表示10%及以上，0.2-1表示20%及以上。\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"viralRateRange\",\"in\":\"query\",\"description\":\"爆文率范围，格式为小数最小值-最大值。页面预设包括0-0.1、0.1-0.25、0.25-0.5、0.5-0.99、0.99及以上。对于开放式预设，传入一个较大的上限，如0.99-1。示例：0.1-0.25。\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"progressTaskRange\",\"in\":\"query\",\"description\":\"进行中任务数量范围。在天数和最小-最大范围之间放置冒号；省略任一边界以表示开放范围。示例：30:8-\",\"required\":false,\"schema\":{\"type\":\"string\"}},{\"name\":\"isCuratedAuthor\",\"in\":\"query\",\"description\":\"是否仅包含话题推荐下的星图精选创作者。\",\"required\":false,\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"name\":\"authorList\",\"in\":\"query\",\"description\":\"星图话题推荐下的活动精选创作者列表。最多选择一个值。传入枚举名称、数字列表ID或中文标签。可选值：SHORT_LIVE_ENTERTAINMENT_CREATORS/7540478044453486642/短直联动娱播达人; SHORT_DRAMA_ACTORS/7591708652957155378/短剧演员; WECHAT_QUICK_CONNECT_CREATORS/7644854622347100210/企微可快速建联达人; AI_STAR_PLAN_CREATORS/7658250094571814938/AI星企划达人; COMMERCE_ADVANTAGE_CREATORS/7648906835038568499/带货优势达人; HIGH_VALUE_CREATORS/7656639212045516826/高性价比达人; SEEDING_ADVANTAGE_CREATORS/7663404694186033202/种草优势达人; BASKETBALL_CREATORS/7501674900550238234/运动圈层达人-篮球; PREMIUM_CONTENT_MEDIA/7586629331582222374/精品内容型媒体推荐; TREND_SETTING_MEDIA/7586616213569781769/趋势造风型媒体推荐; FACTORY_TRACEABILITY_MEDIA/7586616269403832370/探厂溯源型媒体推荐; RUNNING_CREATORS/7501675026170281994/运动圈层达人-跑步; LIGHT_OUTDOOR_CREATORS/7501674458878181413/运动圈层达人-轻户外; FITNESS_CREATORS/7501674307430236197/运动圈层达人-运动健身; YOGA_CREATORS/7501678481074929674/运动圈层达人-瑜伽; STREET_SPORTS_CREATORS/7501677564604383259/运动圈层达人-街头运动; CYCLING_CREATORS/7501677556094042149/运动圈层达人-骑行; FOOTBALL_CREATORS/7501674900550483994/运动圈层达人-足球; FISHING_CREATORS/7501676465915215881/运动圈层达人-垂钓; BEAUTY_QUALITY_CREATORS/7460387606572875826/美妆质感达人.\\n\\n可用值：\\n- `SHORT_LIVE_ENTERTAINMENT_CREATORS`: 短视频和直播娱乐达人\\n- `SHORT_DRAMA_ACTORS`: 短剧演员\\n- `WECHAT_QUICK_CONNECT_CREATORS`: 可快速通过企业微信联系的达人\\n- `AI_STAR_PLAN_CREATORS`: AI星企划达人\\n- `COMMERCE_ADVANTAGE_CREATORS`: 带货优势达人\\n- `HIGH_VALUE_CREATORS`: 高价值达人\\n- `SEEDING_ADVANTAGE_CREATORS`: 种草优势达人\\n- `BASKETBALL_CREATORS`: 篮球达人\\n- `PREMIUM_CONTENT_MEDIA`: 精品内容型媒体推荐\\n- `TREND_SETTING_MEDIA`: 趋势造风型媒体推荐\\n- `FACTORY_TRACEABILITY_MEDIA`: 探厂溯源型媒体推荐\\n- `RUNNING_CREATORS`: 跑步达人\\n- `LIGHT_OUTDOOR_CREATORS`: 轻户外达人\\n- `FITNESS_CREATORS`: 运动健身达人\\n- `YOGA_CREATORS`: 瑜伽达人\\n- `STREET_SPORTS_CREATORS`: 街头运动达人\\n- `CYCLING_CREATORS`: 骑行达人\\n- `FOOTBALL_CREATORS`: 足球达人\\n- `FISHING_CREATORS`: 垂钓达人\\n- `BEAUTY_QUALITY_CREATORS`: 美妆质感达人\",\"required\":false,\"schema\":{\"type\":\"string\",\"description\":\"星图活动精选创作者列表\",\"enum\":[\"SHORT_LIVE_ENTERTAINMENT_CREATORS\",\"SHORT_DRAMA_ACTORS\",\"WECHAT_QUICK_CONNECT_CREATORS\",\"AI_STAR_PLAN_CREATORS\",\"COMMERCE_ADVANTAGE_CREATORS\",\"HIGH_VALUE_CREATORS\",\"SEEDING_ADVANTAGE_CREATORS\",\"BASKETBALL_CREATORS\",\"PREMIUM_CONTENT_MEDIA\",\"TREND_SETTING_MEDIA\",\"FACTORY_TRACEABILITY_MEDIA\",\"RUNNING_CREATORS\",\"LIGHT_OUTDOOR_CREATORS\",\"FITNESS_CREATORS\",\"YOGA_CREATORS\",\"STREET_SPORTS_CREATORS\",\"CYCLING_CREATORS\",\"FOOTBALL_CREATORS\",\"FISHING_CREATORS\",\"BEAUTY_QUALITY_CREATORS\"]}}]")'
  :requestBody='JSON.parse("null")'
  :responses='JSON.parse("{\"200\":{\"description\":\"好的\",\"content\":{\"application/json\":{\"schema\":{\"if\":{\"properties\":{\"code\":{\"const\":0}},\"required\":[\"code\"]},\"then\":{\"properties\":{\"data\":{\"type\":\"object\",\"description\":\"星图达人搜索结果、分页信息和平台状态。\",\"properties\":{\"authors\":{\"type\":\"array\",\"description\":\"当前页的达人。搜索成功时也可能返回空数组。\",\"items\":{\"type\":\"object\",\"description\":\"一条星图达人搜索结果。\",\"properties\":{\"star_id\":{\"type\":\"string\",\"description\":\"星图达人 ID，以字符串返回。\"},\"attribute_datas\":{\"type\":\"object\",\"description\":\"星图返回的达人属性与指标，保留接口原始的字符串形式。\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"星图达人 ID，同一值也见于 `star_id`。\"},\"nick_name\":{\"type\":\"string\",\"description\":\"搜索结果中显示的达人昵称。\"},\"avatar_uri\":{\"type\":\"string\",\"description\":\"星图返回的达人头像引用。\"},\"province\":{\"type\":\"string\",\"description\":\"星图标注的达人所在省份或地区。\"},\"city\":{\"type\":\"string\",\"description\":\"星图标注的达人所在城市。\"},\"gender\":{\"type\":\"string\",\"description\":\"星图标注的达人性别编码，以字符串返回。\"},\"author_type\":{\"type\":\"string\",\"description\":\"星图返回的达人类型编码，以字符串返回。\"},\"follower\":{\"type\":\"string\",\"description\":\"粉丝数，以字符串返回。`followerRange` 按粉丝数的数值筛选。\"},\"fans_increment_rate_within_15d\":{\"type\":\"string\",\"description\":\"星图报告的近 15 天粉丝增长率，以小数文本返回，可以为负。\"},\"fans_increment_within_30d\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天粉丝变动指标，以字符串返回。样本中出现过负数和小数。\"},\"tags_relation\":{\"type\":\"string\",\"contentMediaType\":\"application/json\",\"contentSchema\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"array\",\"description\":\"归在该达人类目下的标签。\",\"items\":{\"type\":\"string\",\"description\":\"单个类目标签。\"}},\"description\":\"以达人类目名称为键、类目标签列表为值的对象。\"},\"description\":\"达人类目标签，以 JSON 对象形式编码在字符串中。\"},\"content_theme_labels_180d\":{\"type\":\"string\",\"contentMediaType\":\"application/json\",\"contentSchema\":{\"type\":\"array\",\"description\":\"解析后的内容主题标签，数组可以为空。\",\"items\":{\"type\":\"string\",\"description\":\"单个内容主题标签。\"}},\"description\":\"近 180 天的内容主题标签，以 JSON 数组形式编码在字符串中。\"},\"last_10_items\":{\"type\":\"string\",\"contentMediaType\":\"application/json\",\"contentSchema\":{\"type\":\"array\",\"description\":\"解析字符串后得到的近期作品条目。\",\"items\":{\"type\":\"object\",\"description\":\"一条近期作品及其统计。\",\"properties\":{\"item_id\":{\"type\":\"string\",\"description\":\"抖音视频 ID。\"},\"item_title\":{\"type\":\"string\",\"description\":\"近期作品的标题文案。\"},\"item_create_time\":{\"type\":\"string\",\"description\":\"视频创建时间，以字符串返回的 Unix 秒级时间戳。\"},\"item_publish_time\":{\"type\":\"string\",\"description\":\"视频发布时间，以字符串返回的 Unix 秒级时间戳。\"},\"vv\":{\"type\":\"string\",\"description\":\"近期作品统计中的播放量，以字符串返回。关联视频列表有独立的播放指标。\"},\"like_cnt\":{\"type\":\"string\",\"description\":\"近期作品统计中的点赞数，以字符串返回。\"},\"comment_cnt\":{\"type\":\"string\",\"description\":\"近期作品统计中的评论数，以字符串返回。\"},\"share_cnt\":{\"type\":\"string\",\"description\":\"近期作品统计中的分享数，以字符串返回。\"}}}},\"description\":\"近期作品及其统计，以 JSON 数组形式编码在字符串中。\"},\"is_superstar\":{\"type\":\"string\",\"description\":\"星图是否将该达人标记为明星，以字符串返回。\"},\"is_curated_author\":{\"type\":\"string\",\"description\":\"星图精选达人标记，可用时以字符串返回。\"},\"price_20_60\":{\"type\":\"string\",\"description\":\"植入视频报价，单位为元，以沿用原 21 至 60 秒报价命名的字段返回字符串。\"},\"price_60\":{\"type\":\"string\",\"description\":\"定制视频报价，单位为元，以沿用原 60 秒以上报价命名的字段返回字符串。\"},\"expected_play_num\":{\"type\":\"string\",\"description\":\"星图报告的预期视频播放量，以字符串返回。\"},\"expected_natural_play_num\":{\"type\":\"string\",\"description\":\"星图报告的预期自然播放量，以字符串返回。\"},\"sn_expected_play_num\":{\"type\":\"string\",\"description\":\"`expectedPlayRange` 使用的预期播放量，以字符串返回。\"},\"prospective_20_60_cpm\":{\"type\":\"string\",\"description\":\"植入视频的预期千次播放成本，以字符串返回。\"},\"prospective_60_cpm\":{\"type\":\"string\",\"description\":\"定制视频的预期千次播放成本，以字符串返回。\"},\"sn_prospective_20_60_cpm\":{\"type\":\"string\",\"description\":\"`expectedCpmRange` 使用的植入视频预期千次播放成本，以字符串返回。\"},\"sn_prospective_60_cpm\":{\"type\":\"string\",\"description\":\"星图报告的定制视频预期千次播放成本，以字符串返回。\"},\"sn_prospective_20_60_cpe\":{\"type\":\"string\",\"description\":\"`expectedCpeRange` 使用的植入视频预期单次互动成本，以字符串返回。\"},\"sn_prospective_60_cpe\":{\"type\":\"string\",\"description\":\"定制视频的预期单次互动成本，以字符串返回。\"},\"interact_rate_within_30d\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天互动率，以小数文本返回。\"},\"play_over_rate_within_30d\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天完播率，以小数文本返回。\"},\"sn_interact_rate_within_30d\":{\"type\":\"string\",\"description\":\"`interactionRateRange` 使用的近 30 天互动率，以小数文本返回。\"},\"sn_play_over_rate_within_30d\":{\"type\":\"string\",\"description\":\"`completionRateRange` 使用的近 30 天完播率，以小数文本返回。\"},\"burst_text_rate\":{\"type\":\"string\",\"description\":\"`viralRateRange` 使用的爆款内容比例，可用时以小数文本返回。\"},\"vv_median_30d\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天视频播放量中位数，以字符串返回。\"},\"interaction_median_30d\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天视频互动量中位数，以字符串返回。\"},\"star_item_count_within_30d\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天星图作品数，可用时以字符串返回。\"},\"is_cocreate_author\":{\"type\":\"string\",\"description\":\"星图报告的共创达人标记，以字符串返回。\"},\"is_short_drama\":{\"type\":\"string\",\"description\":\"星图报告的短剧达人标记，可用时以字符串返回。\"},\"e_commerce_enable\":{\"type\":\"string\",\"description\":\"星图报告的电商能力标记，可用时以字符串返回。\"},\"ecom_video_product_num_30d\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天电商视频商品数，以字符串返回。\"},\"ecom_gmv_30d_range\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天商品交易总额区间，以展示文本返回。\"},\"ecom_avg_order_value_30d_range\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天客单价区间，以展示文本返回。\"},\"ecom_gpm_30d_range\":{\"type\":\"string\",\"description\":\"星图报告的近 30 天电商 GPM 区间，以展示文本返回。\"}}},\"items\":{\"type\":\"array\",\"description\":\"该达人搜索结果关联的视频。\",\"items\":{\"type\":\"object\",\"description\":\"搜索结果中的一条关联视频。\",\"properties\":{\"item_id\":{\"type\":\"string\",\"description\":\"关联视频的抖音 ID。\"},\"vv\":{\"type\":\"integer\",\"description\":\"关联视频返回的播放指标，可缺省。其统计口径可能与近期作品不同。\"},\"products\":{\"type\":\"array\",\"description\":\"内容搜索中关联视频的商品条目，可缺省或返回空数组。\"}}}},\"task_infos\":{\"type\":\"array\",\"description\":\"达人可用的任务与报价记录，数组可以为空。\",\"items\":{\"type\":\"object\",\"description\":\"该达人的一条任务记录。\",\"properties\":{\"task_category\":{\"type\":\"integer\",\"description\":\"星图任务类别编码。\"},\"task_status\":{\"type\":\"integer\",\"description\":\"星图返回的任务状态编码。\"},\"online_status\":{\"type\":\"integer\",\"description\":\"星图返回的任务上线状态编码。\"},\"platform_source\":{\"type\":\"integer\",\"description\":\"星图返回的任务所属平台编码。\"},\"price_infos\":{\"type\":\"array\",\"description\":\"按合作类型返回的报价。\",\"items\":{\"type\":\"object\",\"description\":\"一条报价。\",\"properties\":{\"video_type\":{\"type\":\"integer\",\"description\":\"星图报价类型编码。2 为植入视频，71 为定制视频。\"},\"price\":{\"type\":\"integer\",\"description\":\"报价金额。植入视频和定制视频报价的单位为元。\"},\"start_time\":{\"type\":\"string\",\"description\":\"报价生效开始时间，可用时以 Unix 秒级时间戳字符串返回。\"},\"end_time\":{\"type\":\"string\",\"description\":\"报价生效结束时间，可用时以 Unix 秒级时间戳字符串返回。\"},\"video_type_status\":{\"type\":\"integer\",\"description\":\"星图返回的该报价类型状态编码。\"},\"platform_source\":{\"type\":\"integer\",\"description\":\"星图返回的该报价所属平台编码。\"},\"task_category\":{\"type\":\"integer\",\"description\":\"星图返回的该报价所属任务类别编码。\"}}}}}}}}}},\"pagination\":{\"type\":\"object\",\"description\":\"星图返回的分页信息。\",\"properties\":{\"page\":{\"type\":\"integer\",\"description\":\"当前页码，从 1 开始。\"},\"limit\":{\"type\":\"integer\",\"description\":\"每页结果数上限，实际返回的达人数可能更少。\"},\"total_count\":{\"type\":\"integer\",\"description\":\"星图报告的匹配结果总数。\"},\"has_more\":{\"type\":\"boolean\",\"description\":\"星图是否报告还有下一页。为 true 时，增加 `page` 并沿用同一组筛选条件。\"}}},\"base_resp\":{\"type\":\"object\",\"description\":\"星图返回的搜索状态。\",\"properties\":{\"status_code\":{\"type\":\"integer\",\"description\":\"星图搜索状态码。外层 `code` 是 JustOneAPI 的业务状态码。\"},\"status_message\":{\"type\":\"string\",\"description\":\"星图搜索状态消息。\"}}}}}}},\"allOf\":[{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}]}}}},\"400\":{\"description\":\"请求参数或请求体无效\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"401\":{\"description\":\"访问令牌无效或未激活\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"403\":{\"description\":\"权限不足\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"429\":{\"description\":\"请求速率或每日配额已超限\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"500\":{\"description\":\"服务器内部错误\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"503\":{\"description\":\"服务暂时不可用\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}}}")'
  :servers='JSON.parse("[{\"url\":\"https://api.justoneapi.com\",\"description\":\"全球生产 API（默认）\"}]")'
  :security='JSON.parse("[]")'
  :securitySchemes='JSON.parse("{}")'
  :schemas='JSON.parse("{}")'
/>

<ApiHealthSection :api='JSON.parse("\"/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1\"")' />

<p>通过关键词和结构化筛选（包括受众、定价、内容、表现和活动匹配度）搜索抖音巨量星图创作者。用于构建和比较活动候选名单。</p>

## 请求参数

<div class="api-doc-table api-doc-table--params">

| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- | --- |
| <code>token</code> | query | <code>string</code> | 是 | - | 用户鉴权令牌。 |
| <code>keyword</code> | query | <code>string</code> | 否 | <code></code> | 搜索关键词。 |
| <code>page</code> | query | <code>integer</code> | 否 | <code>1</code> | 用于分页的页码。 |
| <code>sort</code> | query | <code>string</code> | 否 | <code>FANS</code> | 创作者搜索排序。可选值：FANS 按粉丝数降序排序，DEFAULT 使用星图评分排序。<br /><br><br>可选值：<br /><br>- <code>DEFAULT</code>：平台默认评分排序<br /><br>- <code>FANS</code>：按粉丝数降序排序 |
| <code>searchType</code> | query | <code>string</code> | 否 | <code>NICKNAME</code> | 搜索条件类型。<br /><br><br>可用值：<br /><br>- <code>NICKNAME</code>: 按昵称<br /><br>- <code>CONTENT</code>: 按内容 |
| <code>marketingTarget</code> | query | <code>string</code> | 否 | - | 营销目标。可选值：BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化。<br /><br><br>可选值：<br /><br>- <code>BRAND_EXPOSURE</code>: 品牌曝光<br /><br>- <code>CIRCLE_SEEDING</code>: 破圈种草<br /><br>- <code>ACTION_CONVERSION</code>: 行动转化 |
| <code>industry</code> | query | <code>string</code> | 否 | <code>ALL</code> | 推荐行业筛选。传入枚举名称、数字行业ID或中文行业标签。可用值：- ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936: 医疗机构; - 1909: 家居建材; - 1907: 生活服务; - 1906: 商务服务; - 1921: 休闲娱乐; - 1937: 丽人; - 1908: 房地产; - 1910: 教育培训; - 1911: 出行旅游; - 1912: 社会公共; - 1913: 游戏; - 1914: 互联网电商服务; - 1915: 交通工具; - 1916: 汽车; - 1917: 农资园艺; - 1920: 机械设备; - 1939: 文化用品; - 1940: 运动户外; - 1922: 传媒资讯; - 1924: 通信; - 1925: 金融业; - 1927: 餐饮服务; - 1928: 工具类软件; - 1929: 招商加盟; - 1930: 美妆; - 1931: 母婴宠物; - 1933: 日化; - 1934: 实体书籍; - 1935: 社交通讯.<br /><br><br>可用值：<br /><br>- <code>ALL</code>：全部<br /><br>- <code>ELECTRONICS_AND_APPLIANCES</code>：3C及电器<br /><br>- <code>SHOPPING</code>：购物<br /><br>- <code>FOOD_AND_BEVERAGE</code>：食品饮料<br /><br>- <code>CLOTHING_AND_ACCESSORIES</code>：服装配饰<br /><br>- <code>HEALTHCARE_AND_MEDICAL</code>：医药健康<br /><br>- <code>MEDICAL_INSTITUTIONS</code>：医疗机构<br /><br>- <code>HOME_AND_BUILDING_MATERIALS</code>：家居建材<br /><br>- <code>LOCAL_SERVICES</code>：生活服务<br /><br>- <code>BUSINESS_SERVICES</code>：商务服务<br /><br>- <code>CULTURE_SPORTS_ENTERTAINMENT</code>：休闲娱乐<br /><br>- <code>BEAUTY_SERVICES</code>：丽人<br /><br>- <code>REAL_ESTATE</code>：房地产<br /><br>- <code>EDUCATION_AND_TRAINING</code>：教育培训<br /><br>- <code>TRAVEL_AND_TOURISM</code>：出行旅游<br /><br>- <code>PUBLIC_SERVICES</code>：社会公共<br /><br>- <code>GAMES</code>：游戏<br /><br>- <code>RETAIL</code>：互联网电商服务<br /><br>- <code>TRANSPORTATION_EQUIPMENT</code>：交通工具<br /><br>- <code>AUTOMOTIVE</code>：汽车<br /><br>- <code>AGRICULTURE_FORESTRY_FISHERY</code>：农资园艺<br /><br>- <code>CHEMICAL_AND_ENERGY</code>：化工能源<br /><br>- <code>ELECTRONICS_AND_ELECTRICAL</code>：电子电气<br /><br>- <code>MACHINERY_EQUIPMENT</code>：机械设备<br /><br>- <code>MEDIA_AND_INFORMATION</code>：传媒资讯<br /><br>- <code>LOGISTICS</code>：物流仓储<br /><br>- <code>TELECOMMUNICATIONS</code>：通信<br /><br>- <code>FINANCIAL_SERVICES</code>：金融业<br /><br>- <code>CATERING_SERVICES</code>：餐饮服务<br /><br>- <code>SOFTWARE_TOOLS</code>：工具类软件<br /><br>- <code>FRANCHISING_AND_INVESTMENT</code>：招商加盟<br /><br>- <code>BEAUTY_AND_COSMETICS</code>：美妆<br /><br>- <code>MOTHER_BABY_AND_PET</code>：母婴宠物<br /><br>- <code>DAILY_CHEMICALS</code>：日化<br /><br>- <code>PHYSICAL_BOOKS</code>：实体书籍<br /><br>- <code>SOCIAL_AND_COMMUNICATION</code>：社交通讯<br /><br>- <code>CULTURAL_SUPPLIES</code>：文化用品<br /><br>- <code>SPORTS_OUTDOOR</code>：运动户外 |
| <code>isSuperstar</code> | query | <code>boolean</code> | 否 | <code>false</code> | 是否筛选达人创作者。 |
| <code>followerRange</code> | query | <code>string</code> | 否 | - | 原始粉丝数量范围，格式为最小值-最大值。例如：1000-2000表示1000到2000个粉丝；5000000-10000000表示500万到1000万个粉丝。 |
| <code>kolPriceType</code> | query | <code>string</code> | 否 | - | 当前巨量星图市场选项中的创作者报价类型。<br /><br><br>可用值：<br /><br>- <code>PRODUCT_PLACEMENT_VIDEO</code>: 产品植入视频<br /><br>- <code>CUSTOM_VIDEO</code>: 定制视频<br /><br>- <code>CUSTOM_SHORT_DRAMA_EPISODE</code>: 迷你剧集<br /><br>- <code>NATURAL_PLAY_CPM</code>: 自然播放 CPM<br /><br>- <code>SHORT_LIVE_SEEDING_VIDEO</code>: 短直种草视频<br /><br>- <code>SHORT_LIVE_WARMUP_VIDEO</code>: 短直预热视频<br /><br>- <code>CELEBRITY_SHORT_LIVE_SEEDING</code>: 达人短直种草<br /><br>- <code>CELEBRITY_SHORT_LIVE_WARMUP</code>: 达人短直预热<br /><br>- <code>CELEBRITY_VIDEO</code>: 达人视频<br /><br>- <code>COLLECTION_VIDEO</code>: 合集视频<br /><br>- <code>DOUYIN_SHORT_VIDEO_CO_CREATION_MAIN_CREATOR</code>: 抖音短视频共创 - 主创作者<br /><br>- <code>DOUYIN_SHORT_VIDEO_CO_CREATION_PARTICIPANT</code>: 抖音短视频共创 - 参与者 |
| <code>kolPriceRange</code> | query | <code>string</code> | 否 | - | 创作者报价范围，采用最小-最大格式（例如：10000-50000）。需要 kolPriceType；省略 kolPriceRange 以使用所选报价类型的完整范围。 |
| <code>contentTag</code> | query | <code>string</code> | 否 | - | 创作者分类筛选。传入星图一级或二级分类标签，多个用逗号分隔。可选值：- 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次元: 二次元真人, 动画漫画, 配音声优, 宅物手办; - 旅行: 旅行记录, 旅行攻略, 旅行推荐, 户外生活; - 汽车: 汽车测评, 汽车知识, 汽车周边; - 生活: 生活记录, 生活小窍门, 好物推荐, 健康养生, 婚恋; - 音乐: 歌曲演唱, 乐器演奏, 音乐教学, 音乐其他, 音乐剪辑; - 舞蹈; - 美食: 美食教程, 美食探店, 美食产品测评, 乡村野食, 美食其他, 酒类; - 母婴亲子: 育儿科普, 萌娃日常, 亲子互动, 测评种草; - 运动健身: 健身, 极限运动, 体育资讯, 冰雪, 垂钓, 格斗, 球类项目, 综合体育; - 科技数码: 3C数码, 家居电器, 科技; - 教育培训: 考学培训, 语言教学, 个人管理, 职业教育; - 颜值达人: 美女, 帅哥; - 生活家居: 硬装, 软装, 生活技巧, 家居氛围; - 才艺技能: 创意才能, 手工, 摄影, 绘画, 其他才艺; - 影视娱乐: 影视解说, 影视混剪, 明星资讯, 综艺解说, 综艺混剪; - 艺术文化: 传统文化, 人文科普, 自然科学; - 财经投资: 传统金融, 互联网金融, 财经知识; - 三农; - 剧情搞笑: 剧情, 搞笑; - 情感; - 园艺; - 房产: 其他房产, 房产知识, 房产及投资, 楼盘评测, 楼市资讯, 租房; - 随拍; - 媒体号。示例：美妆,穿搭,剧情搞笑 |
| <code>contentTheme</code> | query | <code>string</code> | 否 | - | 内容主题过滤。传入星图二级内容主题标签，用逗号分隔。仅接受冒号后列出的标签；冒号前的类别标题仅为描述性内容，不可传入。可用值包括： - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常菜谱, 美食探店, 零食测评, 酒水品鉴, 厨房用品, 海鲜烹饪, 减脂美食; - 精彩车生活: 汽车行业资讯, 用车知识, 车辆保养, 自驾旅行, 新能源汽车资讯, 汽车用品测评, SUV测评; - 手机/数码/家电分享: 科技科普, 电子产品测评, 家电推荐, 手机评测, 智能家居, AI应用, 数码开箱; - 剧情演绎: 搞笑剧情, 剧情反转, 情感演绎, 家庭幽默演绎, 职场趣闻, 古风剧情, 生存挑战; - 萌宠养护: 宠物狗故事, 动物萌态, 宠物养护, 猫咪萌态, 宠物健康, 宠物护理, 宠物救助; - 旅行攻略: 国内旅行, 海外旅行, 城市旅行攻略, 酒店体验, 露营体验, 亲子旅行, 网红景点种草; - 家居好物: 清洁技巧, 生活好物评测, 家居选购, 家居装修, 家居收纳, 家装避坑, 房间布置; - 运动户外: 户外运动, 健身塑形, 赛事回顾, 体重管理, 极限运动, 跑步健身, 户外露营. 示例：亲子活动,宝宝辅食 |
| <code>personaTag</code> | query | <code>string</code> | 否 | - | 创作者人设或背景标签。传入星图标签或数字标签ID，多个用逗号分隔。可选值：- 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白, 抗老, 祛皱, 抗炎, 修复, 控油, 眼部护理, 补水保湿, 祛斑, 祛痘祛闭口, 隔离防晒; - 母婴阶段: 孕期, 0-6月, 7-12月, 1-3岁, 3-6岁, 6-12岁, 12-15岁, 15-18岁; - 爱好: 摄影, 时尚穿搭, 美食制作, 科普, 星座, 绘画; - 职业: 法律从业者, 航空业从业者, 健身/舞蹈教练, 专业美食从业者, 室内设计师; - 学历: 大学生, 硕士生, 博士, 留学生; - 黄v认证: 美妆创作者, 体育创作者, 媒体人/主持人, 科技创作者, 运动员; - 其他标签: 潮流运动, 球类, 非球类, 室内健身, 城市运动, 户外运动, 数码潮流玩家, 户外爱好者, 室内设计师, 品酒家/调酒师, 美食评论人, 母婴行业专家, 奶爸, 旧屋改造, 装修设计, 收纳, 新生儿妈妈, 孕妈, 时尚妈妈, 二三胎妈妈, 西餐, 火锅, 国风爱好者, 成分党。示例：大学生,美妆创作者 |
| <code>gender</code> | query | <code>string</code> | 否 | - | 创作者性别。可选值：MALE/1/男性, FEMALE/2/女性。<br /><br><br>可选值：<br /><br>- <code>MALE</code>: 男性<br /><br>- <code>FEMALE</code>: 女性 |
| <code>location</code> | query | <code>string</code> | 否 | - | 创作者地域筛选。传入中国省份或城市名称，多个用逗号分隔。可选省份值包括：北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别行政区, 澳门特别行政区。示例：广东省,深圳市 |
| <code>tonalityTag</code> | query | <code>string</code> | 否 | - | 创作者调性标签。传入星图一级或二级调性标签，多个用逗号分隔。可选值：- 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球。示例：精致达人,设计师 |
| <code>connectedUserRange</code> | query | <code>string</code> | 否 | - | 关联用户数范围。传入原始用户数，格式为最小值-最大值。示例：1000000-3000000 |
| <code>audienceImage</code> | query | <code>string</code> | 否 | - | 受众画像筛选条件, 来自星图受众画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: 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_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - 设备: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - 城市等级: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - 平均订单金额: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - 人群画像: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). 括号中的数字 ID 和中文标签仅供参考, 不作为输入值. 示例: GENDER_FEMALE_50,CROWD_REFINED_MOTHER |
| <code>fansImage</code> | query | <code>string</code> | 否 | - | 粉丝画像筛选条件, 来自星图粉丝画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: 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_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - 设备: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - 城市等级: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - 平均订单金额: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - 人群画像: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). 括号中的数字 ID 和中文标签仅供参考, 不作为输入值. 示例: GENDER_FEMALE_50,CROWD_REFINED_MOTHER |
| <code>expectedPlayRange</code> | query | <code>string</code> | 否 | - | 预期播放量范围。使用原始播放量，格式为最小值-最大值。页面预设包括10000000及以上、5000000-10000000、3000000-5000000、1000000-3000000、100000-1000000、0-100000。对于开放式预设，传入一个较大的上限，如10000000-1000000000。示例：1000000-3000000。 |
| <code>expectedCpmRange</code> | query | <code>string</code> | 否 | - | 预期CPM范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000。 |
| <code>expectedCpeRange</code> | query | <code>string</code> | 否 | - | 预期CPE范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000。 |
| <code>interactionRateRange</code> | query | <code>string</code> | 否 | - | 互动率范围，格式为小数最小值-最大值。示例值：0.01-1表示1%及以上，0.02-1表示2%及以上。 |
| <code>completionRateRange</code> | query | <code>string</code> | 否 | - | 完播率范围，格式为小数最小值-最大值。示例值：0.1-1表示10%及以上，0.2-1表示20%及以上。 |
| <code>viralRateRange</code> | query | <code>string</code> | 否 | - | 爆文率范围，格式为小数最小值-最大值。页面预设包括0-0.1、0.1-0.25、0.25-0.5、0.5-0.99、0.99及以上。对于开放式预设，传入一个较大的上限，如0.99-1。示例：0.1-0.25。 |
| <code>progressTaskRange</code> | query | <code>string</code> | 否 | - | 进行中任务数量范围。在天数和最小-最大范围之间放置冒号；省略任一边界以表示开放范围。示例：30:8- |
| <code>isCuratedAuthor</code> | query | <code>boolean</code> | 否 | <code>false</code> | 是否仅包含话题推荐下的星图精选创作者。 |
| <code>authorList</code> | query | <code>string</code> | 否 | - | 星图话题推荐下的活动精选创作者列表。最多选择一个值。传入枚举名称、数字列表ID或中文标签。可选值：SHORT_LIVE_ENTERTAINMENT_CREATORS/7540478044453486642/短直联动娱播达人; SHORT_DRAMA_ACTORS/7591708652957155378/短剧演员; WECHAT_QUICK_CONNECT_CREATORS/7644854622347100210/企微可快速建联达人; AI_STAR_PLAN_CREATORS/7658250094571814938/AI星企划达人; COMMERCE_ADVANTAGE_CREATORS/7648906835038568499/带货优势达人; HIGH_VALUE_CREATORS/7656639212045516826/高性价比达人; SEEDING_ADVANTAGE_CREATORS/7663404694186033202/种草优势达人; BASKETBALL_CREATORS/7501674900550238234/运动圈层达人-篮球; PREMIUM_CONTENT_MEDIA/7586629331582222374/精品内容型媒体推荐; TREND_SETTING_MEDIA/7586616213569781769/趋势造风型媒体推荐; FACTORY_TRACEABILITY_MEDIA/7586616269403832370/探厂溯源型媒体推荐; RUNNING_CREATORS/7501675026170281994/运动圈层达人-跑步; LIGHT_OUTDOOR_CREATORS/7501674458878181413/运动圈层达人-轻户外; FITNESS_CREATORS/7501674307430236197/运动圈层达人-运动健身; YOGA_CREATORS/7501678481074929674/运动圈层达人-瑜伽; STREET_SPORTS_CREATORS/7501677564604383259/运动圈层达人-街头运动; CYCLING_CREATORS/7501677556094042149/运动圈层达人-骑行; FOOTBALL_CREATORS/7501674900550483994/运动圈层达人-足球; FISHING_CREATORS/7501676465915215881/运动圈层达人-垂钓; BEAUTY_QUALITY_CREATORS/7460387606572875826/美妆质感达人.<br /><br><br>可用值：<br /><br>- <code>SHORT_LIVE_ENTERTAINMENT_CREATORS</code>: 短视频和直播娱乐达人<br /><br>- <code>SHORT_DRAMA_ACTORS</code>: 短剧演员<br /><br>- <code>WECHAT_QUICK_CONNECT_CREATORS</code>: 可快速通过企业微信联系的达人<br /><br>- <code>AI_STAR_PLAN_CREATORS</code>: AI星企划达人<br /><br>- <code>COMMERCE_ADVANTAGE_CREATORS</code>: 带货优势达人<br /><br>- <code>HIGH_VALUE_CREATORS</code>: 高价值达人<br /><br>- <code>SEEDING_ADVANTAGE_CREATORS</code>: 种草优势达人<br /><br>- <code>BASKETBALL_CREATORS</code>: 篮球达人<br /><br>- <code>PREMIUM_CONTENT_MEDIA</code>: 精品内容型媒体推荐<br /><br>- <code>TREND_SETTING_MEDIA</code>: 趋势造风型媒体推荐<br /><br>- <code>FACTORY_TRACEABILITY_MEDIA</code>: 探厂溯源型媒体推荐<br /><br>- <code>RUNNING_CREATORS</code>: 跑步达人<br /><br>- <code>LIGHT_OUTDOOR_CREATORS</code>: 轻户外达人<br /><br>- <code>FITNESS_CREATORS</code>: 运动健身达人<br /><br>- <code>YOGA_CREATORS</code>: 瑜伽达人<br /><br>- <code>STREET_SPORTS_CREATORS</code>: 街头运动达人<br /><br>- <code>CYCLING_CREATORS</code>: 骑行达人<br /><br>- <code>FOOTBALL_CREATORS</code>: 足球达人<br /><br>- <code>FISHING_CREATORS</code>: 垂钓达人<br /><br>- <code>BEAUTY_QUALITY_CREATORS</code>: 美妆质感达人 |

</div>

## 代码示例

::: code-group

```bash [🐚 cURL]
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY'
```

```text [🤖 AI 提示词]
我想使用 JustOneAPI 提供的“创作者搜索 (V1)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY
接口地址: BASE_URL + /api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douyin-creator-marketplace-xingtu/creator-search-v1-zh.json

请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- keyword (query): 搜索关键词。
- page (query): 用于分页的页码。
- sort (query): 创作者搜索排序。可选值：FANS 按粉丝数降序排序，DEFAULT 使用星图评分排序。

可选值：
- `DEFAULT`：平台默认评分排序
- `FANS`：按粉丝数降序排序
- searchType (query): 搜索条件类型。

可用值：
- `NICKNAME`: 按昵称
- `CONTENT`: 按内容
- marketingTarget (query): 营销目标。可选值：BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化。

可选值：
- `BRAND_EXPOSURE`: 品牌曝光
- `CIRCLE_SEEDING`: 破圈种草
- `ACTION_CONVERSION`: 行动转化
- industry (query): 推荐行业筛选。传入枚举名称、数字行业ID或中文行业标签。可用值：- ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936: 医疗机构; - 1909: 家居建材; - 1907: 生活服务; - 1906: 商务服务; - 1921: 休闲娱乐; - 1937: 丽人; - 1908: 房地产; - 1910: 教育培训; - 1911: 出行旅游; - 1912: 社会公共; - 1913: 游戏; - 1914: 互联网电商服务; - 1915: 交通工具; - 1916: 汽车; - 1917: 农资园艺; - 1920: 机械设备; - 1939: 文化用品; - 1940: 运动户外; - 1922: 传媒资讯; - 1924: 通信; - 1925: 金融业; - 1927: 餐饮服务; - 1928: 工具类软件; - 1929: 招商加盟; - 1930: 美妆; - 1931: 母婴宠物; - 1933: 日化; - 1934: 实体书籍; - 1935: 社交通讯.

可用值：
- `ALL`：全部
- `ELECTRONICS_AND_APPLIANCES`：3C及电器
- `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`：运动户外
- isSuperstar (query): 是否筛选达人创作者。
- followerRange (query): 原始粉丝数量范围，格式为最小值-最大值。例如：1000-2000表示1000到2000个粉丝；5000000-10000000表示500万到1000万个粉丝。
- kolPriceType (query): 当前巨量星图市场选项中的创作者报价类型。

可用值：
- `PRODUCT_PLACEMENT_VIDEO`: 产品植入视频
- `CUSTOM_VIDEO`: 定制视频
- `CUSTOM_SHORT_DRAMA_EPISODE`: 迷你剧集
- `NATURAL_PLAY_CPM`: 自然播放 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 (query): 创作者报价范围，采用最小-最大格式（例如：10000-50000）。需要 kolPriceType；省略 kolPriceRange 以使用所选报价类型的完整范围。
- contentTag (query): 创作者分类筛选。传入星图一级或二级分类标签，多个用逗号分隔。可选值：- 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次元: 二次元真人, 动画漫画, 配音声优, 宅物手办; - 旅行: 旅行记录, 旅行攻略, 旅行推荐, 户外生活; - 汽车: 汽车测评, 汽车知识, 汽车周边; - 生活: 生活记录, 生活小窍门, 好物推荐, 健康养生, 婚恋; - 音乐: 歌曲演唱, 乐器演奏, 音乐教学, 音乐其他, 音乐剪辑; - 舞蹈; - 美食: 美食教程, 美食探店, 美食产品测评, 乡村野食, 美食其他, 酒类; - 母婴亲子: 育儿科普, 萌娃日常, 亲子互动, 测评种草; - 运动健身: 健身, 极限运动, 体育资讯, 冰雪, 垂钓, 格斗, 球类项目, 综合体育; - 科技数码: 3C数码, 家居电器, 科技; - 教育培训: 考学培训, 语言教学, 个人管理, 职业教育; - 颜值达人: 美女, 帅哥; - 生活家居: 硬装, 软装, 生活技巧, 家居氛围; - 才艺技能: 创意才能, 手工, 摄影, 绘画, 其他才艺; - 影视娱乐: 影视解说, 影视混剪, 明星资讯, 综艺解说, 综艺混剪; - 艺术文化: 传统文化, 人文科普, 自然科学; - 财经投资: 传统金融, 互联网金融, 财经知识; - 三农; - 剧情搞笑: 剧情, 搞笑; - 情感; - 园艺; - 房产: 其他房产, 房产知识, 房产及投资, 楼盘评测, 楼市资讯, 租房; - 随拍; - 媒体号。示例：美妆,穿搭,剧情搞笑
- contentTheme (query): 内容主题过滤。传入星图二级内容主题标签，用逗号分隔。仅接受冒号后列出的标签；冒号前的类别标题仅为描述性内容，不可传入。可用值包括： - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常菜谱, 美食探店, 零食测评, 酒水品鉴, 厨房用品, 海鲜烹饪, 减脂美食; - 精彩车生活: 汽车行业资讯, 用车知识, 车辆保养, 自驾旅行, 新能源汽车资讯, 汽车用品测评, SUV测评; - 手机/数码/家电分享: 科技科普, 电子产品测评, 家电推荐, 手机评测, 智能家居, AI应用, 数码开箱; - 剧情演绎: 搞笑剧情, 剧情反转, 情感演绎, 家庭幽默演绎, 职场趣闻, 古风剧情, 生存挑战; - 萌宠养护: 宠物狗故事, 动物萌态, 宠物养护, 猫咪萌态, 宠物健康, 宠物护理, 宠物救助; - 旅行攻略: 国内旅行, 海外旅行, 城市旅行攻略, 酒店体验, 露营体验, 亲子旅行, 网红景点种草; - 家居好物: 清洁技巧, 生活好物评测, 家居选购, 家居装修, 家居收纳, 家装避坑, 房间布置; - 运动户外: 户外运动, 健身塑形, 赛事回顾, 体重管理, 极限运动, 跑步健身, 户外露营. 示例：亲子活动,宝宝辅食
- personaTag (query): 创作者人设或背景标签。传入星图标签或数字标签ID，多个用逗号分隔。可选值：- 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白, 抗老, 祛皱, 抗炎, 修复, 控油, 眼部护理, 补水保湿, 祛斑, 祛痘祛闭口, 隔离防晒; - 母婴阶段: 孕期, 0-6月, 7-12月, 1-3岁, 3-6岁, 6-12岁, 12-15岁, 15-18岁; - 爱好: 摄影, 时尚穿搭, 美食制作, 科普, 星座, 绘画; - 职业: 法律从业者, 航空业从业者, 健身/舞蹈教练, 专业美食从业者, 室内设计师; - 学历: 大学生, 硕士生, 博士, 留学生; - 黄v认证: 美妆创作者, 体育创作者, 媒体人/主持人, 科技创作者, 运动员; - 其他标签: 潮流运动, 球类, 非球类, 室内健身, 城市运动, 户外运动, 数码潮流玩家, 户外爱好者, 室内设计师, 品酒家/调酒师, 美食评论人, 母婴行业专家, 奶爸, 旧屋改造, 装修设计, 收纳, 新生儿妈妈, 孕妈, 时尚妈妈, 二三胎妈妈, 西餐, 火锅, 国风爱好者, 成分党。示例：大学生,美妆创作者
- gender (query): 创作者性别。可选值：MALE/1/男性, FEMALE/2/女性。

可选值：
- `MALE`: 男性
- `FEMALE`: 女性
- location (query): 创作者地域筛选。传入中国省份或城市名称，多个用逗号分隔。可选省份值包括：北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别行政区, 澳门特别行政区。示例：广东省,深圳市
- tonalityTag (query): 创作者调性标签。传入星图一级或二级调性标签，多个用逗号分隔。可选值：- 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球。示例：精致达人,设计师
- connectedUserRange (query): 关联用户数范围。传入原始用户数，格式为最小值-最大值。示例：1000000-3000000
- audienceImage (query): 受众画像筛选条件, 来自星图受众画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: 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_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - 设备: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - 城市等级: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - 平均订单金额: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - 人群画像: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). 括号中的数字 ID 和中文标签仅供参考, 不作为输入值. 示例: GENDER_FEMALE_50,CROWD_REFINED_MOTHER
- fansImage (query): 粉丝画像筛选条件, 来自星图粉丝画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: 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_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - 设备: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - 城市等级: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - 平均订单金额: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - 人群画像: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). 括号中的数字 ID 和中文标签仅供参考, 不作为输入值. 示例: GENDER_FEMALE_50,CROWD_REFINED_MOTHER
- expectedPlayRange (query): 预期播放量范围。使用原始播放量，格式为最小值-最大值。页面预设包括10000000及以上、5000000-10000000、3000000-5000000、1000000-3000000、100000-1000000、0-100000。对于开放式预设，传入一个较大的上限，如10000000-1000000000。示例：1000000-3000000。
- expectedCpmRange (query): 预期CPM范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000。
- expectedCpeRange (query): 预期CPE范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000。
- interactionRateRange (query): 互动率范围，格式为小数最小值-最大值。示例值：0.01-1表示1%及以上，0.02-1表示2%及以上。
- completionRateRange (query): 完播率范围，格式为小数最小值-最大值。示例值：0.1-1表示10%及以上，0.2-1表示20%及以上。
- viralRateRange (query): 爆文率范围，格式为小数最小值-最大值。页面预设包括0-0.1、0.1-0.25、0.25-0.5、0.5-0.99、0.99及以上。对于开放式预设，传入一个较大的上限，如0.99-1。示例：0.1-0.25。
- progressTaskRange (query): 进行中任务数量范围。在天数和最小-最大范围之间放置冒号；省略任一边界以表示开放范围。示例：30:8-
- isCuratedAuthor (query): 是否仅包含话题推荐下的星图精选创作者。
- authorList (query): 星图话题推荐下的活动精选创作者列表。最多选择一个值。传入枚举名称、数字列表ID或中文标签。可选值：SHORT_LIVE_ENTERTAINMENT_CREATORS/7540478044453486642/短直联动娱播达人; SHORT_DRAMA_ACTORS/7591708652957155378/短剧演员; WECHAT_QUICK_CONNECT_CREATORS/7644854622347100210/企微可快速建联达人; AI_STAR_PLAN_CREATORS/7658250094571814938/AI星企划达人; COMMERCE_ADVANTAGE_CREATORS/7648906835038568499/带货优势达人; HIGH_VALUE_CREATORS/7656639212045516826/高性价比达人; SEEDING_ADVANTAGE_CREATORS/7663404694186033202/种草优势达人; BASKETBALL_CREATORS/7501674900550238234/运动圈层达人-篮球; PREMIUM_CONTENT_MEDIA/7586629331582222374/精品内容型媒体推荐; TREND_SETTING_MEDIA/7586616213569781769/趋势造风型媒体推荐; FACTORY_TRACEABILITY_MEDIA/7586616269403832370/探厂溯源型媒体推荐; RUNNING_CREATORS/7501675026170281994/运动圈层达人-跑步; LIGHT_OUTDOOR_CREATORS/7501674458878181413/运动圈层达人-轻户外; FITNESS_CREATORS/7501674307430236197/运动圈层达人-运动健身; YOGA_CREATORS/7501678481074929674/运动圈层达人-瑜伽; STREET_SPORTS_CREATORS/7501677564604383259/运动圈层达人-街头运动; CYCLING_CREATORS/7501677556094042149/运动圈层达人-骑行; FOOTBALL_CREATORS/7501674900550483994/运动圈层达人-足球; FISHING_CREATORS/7501676465915215881/运动圈层达人-垂钓; BEAUTY_QUALITY_CREATORS/7460387606572875826/美妆质感达人.

可用值：
- `SHORT_LIVE_ENTERTAINMENT_CREATORS`: 短视频和直播娱乐达人
- `SHORT_DRAMA_ACTORS`: 短剧演员
- `WECHAT_QUICK_CONNECT_CREATORS`: 可快速通过企业微信联系的达人
- `AI_STAR_PLAN_CREATORS`: AI星企划达人
- `COMMERCE_ADVANTAGE_CREATORS`: 带货优势达人
- `HIGH_VALUE_CREATORS`: 高价值达人
- `SEEDING_ADVANTAGE_CREATORS`: 种草优势达人
- `BASKETBALL_CREATORS`: 篮球达人
- `PREMIUM_CONTENT_MEDIA`: 精品内容型媒体推荐
- `TREND_SETTING_MEDIA`: 趋势造风型媒体推荐
- `FACTORY_TRACEABILITY_MEDIA`: 探厂溯源型媒体推荐
- `RUNNING_CREATORS`: 跑步达人
- `LIGHT_OUTDOOR_CREATORS`: 轻户外达人
- `FITNESS_CREATORS`: 运动健身达人
- `YOGA_CREATORS`: 瑜伽达人
- `STREET_SPORTS_CREATORS`: 街头运动达人
- `CYCLING_CREATORS`: 骑行达人
- `FOOTBALL_CREATORS`: 足球达人
- `FISHING_CREATORS`: 垂钓达人
- `BEAUTY_QUALITY_CREATORS`: 美妆质感达人

返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。

响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为 120 秒；如果 120 秒偏长，请至少设置为 60 秒，但可能会有少量请求因超时而未接收到结果。
3. 业务码说明：
   - 0: 成功
   - 100: Token 无效或已失效
   - 301: 采集失败，请重试
   - 302: 超出速率限制
   - 303: 超出每日配额
   - 400: 参数错误
   - 500: 内部服务器错误
   - 600: 权限不足
   - 601: 账户余额不足
   - 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨，多个 TOKEN 仍共享同一个账户余额。

请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。
```

```python [🐍 Python]
import requests

BASE_URL = "https://api.justoneapi.com"  # 由 OpenAPI servers 提供

url = BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
    content_type = response.headers.get("content-type", "").lower()
    if "json" in content_type:
        try:
            print(response.json())
        except ValueError:
            print(response.text)
    elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
        print(response.text)
    else:
        with open("response.bin", "wb") as output:
            output.write(response.content)
        print(f"Saved {len(response.content)} bytes to response.bin")
```

```js [🌐 JavaScript]
const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
```

```java [☕ Java]
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
        final String url = BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
```

```go [🐹 Go]
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	url := BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
```

```php [🐘 PHP]
<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}
```

:::

<div style="text-align: right; margin-top: -20px; margin-bottom: 20px;">
<a href="/openapi/douyin-creator-marketplace-xingtu/creator-search-v1-zh.json" target="_blank" style="font-size: 12px; color: var(--vp-c-text-3); text-decoration: none; opacity: 0.8;">[OpenAPI 定义 (JSON)]</a>
</div>

## 返回字段

业务成功时（`code = 0`）的主要返回字段。

<div class="api-doc-table api-doc-table--response">

| 字段路径 | 类型 | 说明 |
| --- | --- | --- |
| <code>data</code> | <code>object</code> | 星图达人搜索结果、分页信息和平台状态。 |
| <code>data.authors</code> | <code>array</code> | 当前页的达人。搜索成功时也可能返回空数组。 |
| <code>data.authors[]</code> | <code>object</code> | 一条星图达人搜索结果。 |
| <code>data.authors[].star_id</code> | <code>string</code> | 星图达人 ID，以字符串返回。 |
| <code>data.authors[].attribute_datas</code> | <code>object</code> | 星图返回的达人属性与指标，保留接口原始的字符串形式。 |
| <code>data.authors[].attribute_datas.id</code> | <code>string</code> | 星图达人 ID，同一值也见于 <code>star_id</code>。 |
| <code>data.authors[].attribute_datas.nick_name</code> | <code>string</code> | 搜索结果中显示的达人昵称。 |
| <code>data.authors[].attribute_datas.avatar_uri</code> | <code>string</code> | 星图返回的达人头像引用。 |
| <code>data.authors[].attribute_datas.province</code> | <code>string</code> | 星图标注的达人所在省份或地区。 |
| <code>data.authors[].attribute_datas.city</code> | <code>string</code> | 星图标注的达人所在城市。 |
| <code>data.authors[].attribute_datas.gender</code> | <code>string</code> | 星图标注的达人性别编码，以字符串返回。 |
| <code>data.authors[].attribute_datas.author_type</code> | <code>string</code> | 星图返回的达人类型编码，以字符串返回。 |
| <code>data.authors[].attribute_datas.follower</code> | <code>string</code> | 粉丝数，以字符串返回。<code>followerRange</code> 按粉丝数的数值筛选。 |
| <code>data.authors[].attribute_datas.fans_increment_rate_within_15d</code> | <code>string</code> | 星图报告的近 15 天粉丝增长率，以小数文本返回，可以为负。 |
| <code>data.authors[].attribute_datas.fans_increment_within_30d</code> | <code>string</code> | 星图报告的近 30 天粉丝变动指标，以字符串返回。样本中出现过负数和小数。 |
| <code>data.authors[].attribute_datas.tags_relation</code> | <code>string</code> | 达人类目标签，以 JSON 对象形式编码在字符串中。 |
| <code>data.authors[].attribute_datas.tags_relation (JSON)</code> | <code>object</code> | 以达人类目名称为键、类目标签列表为值的对象。 |
| <code>data.authors[].attribute_datas.tags_relation (JSON).{key}</code> | <code>array</code> | 归在该达人类目下的标签。 |
| <code>data.authors[].attribute_datas.tags_relation (JSON).{key}[]</code> | <code>string</code> | 单个类目标签。 |
| <code>data.authors[].attribute_datas.content_theme_labels_180d</code> | <code>string</code> | 近 180 天的内容主题标签，以 JSON 数组形式编码在字符串中。 |
| <code>data.authors[].attribute_datas.content_theme_labels_180d (JSON)</code> | <code>array</code> | 解析后的内容主题标签，数组可以为空。 |
| <code>data.authors[].attribute_datas.content_theme_labels_180d (JSON)[]</code> | <code>string</code> | 单个内容主题标签。 |
| <code>data.authors[].attribute_datas.last_10_items</code> | <code>string</code> | 近期作品及其统计，以 JSON 数组形式编码在字符串中。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)</code> | <code>array</code> | 解析字符串后得到的近期作品条目。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)[]</code> | <code>object</code> | 一条近期作品及其统计。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)[].item_id</code> | <code>string</code> | 抖音视频 ID。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)[].item_title</code> | <code>string</code> | 近期作品的标题文案。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)[].item_create_time</code> | <code>string</code> | 视频创建时间，以字符串返回的 Unix 秒级时间戳。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)[].item_publish_time</code> | <code>string</code> | 视频发布时间，以字符串返回的 Unix 秒级时间戳。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)[].vv</code> | <code>string</code> | 近期作品统计中的播放量，以字符串返回。关联视频列表有独立的播放指标。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)[].like_cnt</code> | <code>string</code> | 近期作品统计中的点赞数，以字符串返回。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)[].comment_cnt</code> | <code>string</code> | 近期作品统计中的评论数，以字符串返回。 |
| <code>data.authors[].attribute_datas.last_10_items (JSON)[].share_cnt</code> | <code>string</code> | 近期作品统计中的分享数，以字符串返回。 |
| <code>data.authors[].attribute_datas.is_superstar</code> | <code>string</code> | 星图是否将该达人标记为明星，以字符串返回。 |
| <code>data.authors[].attribute_datas.is_curated_author</code> | <code>string</code> | 星图精选达人标记，可用时以字符串返回。 |
| <code>data.authors[].attribute_datas.price_20_60</code> | <code>string</code> | 植入视频报价，单位为元，以沿用原 21 至 60 秒报价命名的字段返回字符串。 |
| <code>data.authors[].attribute_datas.price_60</code> | <code>string</code> | 定制视频报价，单位为元，以沿用原 60 秒以上报价命名的字段返回字符串。 |
| <code>data.authors[].attribute_datas.expected_play_num</code> | <code>string</code> | 星图报告的预期视频播放量，以字符串返回。 |
| <code>data.authors[].attribute_datas.expected_natural_play_num</code> | <code>string</code> | 星图报告的预期自然播放量，以字符串返回。 |
| <code>data.authors[].attribute_datas.sn_expected_play_num</code> | <code>string</code> | <code>expectedPlayRange</code> 使用的预期播放量，以字符串返回。 |
| <code>data.authors[].attribute_datas.prospective_20_60_cpm</code> | <code>string</code> | 植入视频的预期千次播放成本，以字符串返回。 |
| <code>data.authors[].attribute_datas.prospective_60_cpm</code> | <code>string</code> | 定制视频的预期千次播放成本，以字符串返回。 |
| <code>data.authors[].attribute_datas.sn_prospective_20_60_cpm</code> | <code>string</code> | <code>expectedCpmRange</code> 使用的植入视频预期千次播放成本，以字符串返回。 |
| <code>data.authors[].attribute_datas.sn_prospective_60_cpm</code> | <code>string</code> | 星图报告的定制视频预期千次播放成本，以字符串返回。 |
| <code>data.authors[].attribute_datas.sn_prospective_20_60_cpe</code> | <code>string</code> | <code>expectedCpeRange</code> 使用的植入视频预期单次互动成本，以字符串返回。 |
| <code>data.authors[].attribute_datas.sn_prospective_60_cpe</code> | <code>string</code> | 定制视频的预期单次互动成本，以字符串返回。 |
| <code>data.authors[].attribute_datas.interact_rate_within_30d</code> | <code>string</code> | 星图报告的近 30 天互动率，以小数文本返回。 |
| <code>data.authors[].attribute_datas.play_over_rate_within_30d</code> | <code>string</code> | 星图报告的近 30 天完播率，以小数文本返回。 |
| <code>data.authors[].attribute_datas.sn_interact_rate_within_30d</code> | <code>string</code> | <code>interactionRateRange</code> 使用的近 30 天互动率，以小数文本返回。 |
| <code>data.authors[].attribute_datas.sn_play_over_rate_within_30d</code> | <code>string</code> | <code>completionRateRange</code> 使用的近 30 天完播率，以小数文本返回。 |
| <code>data.authors[].attribute_datas.burst_text_rate</code> | <code>string</code> | <code>viralRateRange</code> 使用的爆款内容比例，可用时以小数文本返回。 |
| <code>data.authors[].attribute_datas.vv_median_30d</code> | <code>string</code> | 星图报告的近 30 天视频播放量中位数，以字符串返回。 |
| <code>data.authors[].attribute_datas.interaction_median_30d</code> | <code>string</code> | 星图报告的近 30 天视频互动量中位数，以字符串返回。 |
| <code>data.authors[].attribute_datas.star_item_count_within_30d</code> | <code>string</code> | 星图报告的近 30 天星图作品数，可用时以字符串返回。 |
| <code>data.authors[].attribute_datas.is_cocreate_author</code> | <code>string</code> | 星图报告的共创达人标记，以字符串返回。 |
| <code>data.authors[].attribute_datas.is_short_drama</code> | <code>string</code> | 星图报告的短剧达人标记，可用时以字符串返回。 |
| <code>data.authors[].attribute_datas.e_commerce_enable</code> | <code>string</code> | 星图报告的电商能力标记，可用时以字符串返回。 |
| <code>data.authors[].attribute_datas.ecom_video_product_num_30d</code> | <code>string</code> | 星图报告的近 30 天电商视频商品数，以字符串返回。 |
| <code>data.authors[].attribute_datas.ecom_gmv_30d_range</code> | <code>string</code> | 星图报告的近 30 天商品交易总额区间，以展示文本返回。 |
| <code>data.authors[].attribute_datas.ecom_avg_order_value_30d_range</code> | <code>string</code> | 星图报告的近 30 天客单价区间，以展示文本返回。 |
| <code>data.authors[].attribute_datas.ecom_gpm_30d_range</code> | <code>string</code> | 星图报告的近 30 天电商 GPM 区间，以展示文本返回。 |
| <code>data.authors[].items</code> | <code>array</code> | 该达人搜索结果关联的视频。 |
| <code>data.authors[].items[]</code> | <code>object</code> | 搜索结果中的一条关联视频。 |
| <code>data.authors[].items[].item_id</code> | <code>string</code> | 关联视频的抖音 ID。 |
| <code>data.authors[].items[].vv</code> | <code>integer</code> | 关联视频返回的播放指标，可缺省。其统计口径可能与近期作品不同。 |
| <code>data.authors[].items[].products</code> | <code>array</code> | 内容搜索中关联视频的商品条目，可缺省或返回空数组。 |
| <code>data.authors[].task_infos</code> | <code>array</code> | 达人可用的任务与报价记录，数组可以为空。 |
| <code>data.authors[].task_infos[]</code> | <code>object</code> | 该达人的一条任务记录。 |
| <code>data.authors[].task_infos[].task_category</code> | <code>integer</code> | 星图任务类别编码。 |
| <code>data.authors[].task_infos[].task_status</code> | <code>integer</code> | 星图返回的任务状态编码。 |
| <code>data.authors[].task_infos[].online_status</code> | <code>integer</code> | 星图返回的任务上线状态编码。 |
| <code>data.authors[].task_infos[].platform_source</code> | <code>integer</code> | 星图返回的任务所属平台编码。 |
| <code>data.authors[].task_infos[].price_infos</code> | <code>array</code> | 按合作类型返回的报价。 |
| <code>data.authors[].task_infos[].price_infos[]</code> | <code>object</code> | 一条报价。 |
| <code>data.authors[].task_infos[].price_infos[].video_type</code> | <code>integer</code> | 星图报价类型编码。2 为植入视频，71 为定制视频。 |
| <code>data.authors[].task_infos[].price_infos[].price</code> | <code>integer</code> | 报价金额。植入视频和定制视频报价的单位为元。 |
| <code>data.authors[].task_infos[].price_infos[].start_time</code> | <code>string</code> | 报价生效开始时间，可用时以 Unix 秒级时间戳字符串返回。 |
| <code>data.authors[].task_infos[].price_infos[].end_time</code> | <code>string</code> | 报价生效结束时间，可用时以 Unix 秒级时间戳字符串返回。 |
| <code>data.authors[].task_infos[].price_infos[].video_type_status</code> | <code>integer</code> | 星图返回的该报价类型状态编码。 |
| <code>data.authors[].task_infos[].price_infos[].platform_source</code> | <code>integer</code> | 星图返回的该报价所属平台编码。 |
| <code>data.authors[].task_infos[].price_infos[].task_category</code> | <code>integer</code> | 星图返回的该报价所属任务类别编码。 |
| <code>data.pagination</code> | <code>object</code> | 星图返回的分页信息。 |
| <code>data.pagination.page</code> | <code>integer</code> | 当前页码，从 1 开始。 |
| <code>data.pagination.limit</code> | <code>integer</code> | 每页结果数上限，实际返回的达人数可能更少。 |
| <code>data.pagination.total_count</code> | <code>integer</code> | 星图报告的匹配结果总数。 |
| <code>data.pagination.has_more</code> | <code>boolean</code> | 星图是否报告还有下一页。为 true 时，增加 <code>page</code> 并沿用同一组筛选条件。 |
| <code>data.base_resp</code> | <code>object</code> | 星图返回的搜索状态。 |
| <code>data.base_resp.status_code</code> | <code>integer</code> | 星图搜索状态码。外层 <code>code</code> 是 JustOneAPI 的业务状态码。 |
| <code>data.base_resp.status_message</code> | <code>string</code> | 星图搜索状态消息。 |

</div>

## 响应示例

<ApiExampleSection :api='JSON.parse("\"/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1\"")' />

