{
  "openapi": "3.1.0",
  "info": {
    "title": "抖音巨量星图创作者搜索 API (V1)",
    "version": "v0",
    "description": "通过关键词和结构化筛选（包括受众、定价、内容、表现和活动匹配度）搜索抖音巨量星图创作者。用于构建和比较活动候选名单。"
  },
  "servers": [
    {
      "url": "https://api.justoneapi.com",
      "description": "全球生产 API（默认）"
    }
  ],
  "tags": [
    {
      "name": "抖音巨量星图",
      "description": "抖音巨量星图创作者指标、受众结构、商业数据和活动分析，用于创作者营销。",
      "x-platform-id": "douyin-creator-marketplace-xingtu",
      "x-platform-aliases": [
        "Douyin Xingtu",
        "Xingtu",
        "巨量星图",
        "星图"
      ],
      "x-platform-detection-aliases": [
        "Douyin Xingtu",
        "Xingtu",
        "巨量星图",
        "星图"
      ]
    }
  ],
  "paths": {
    "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1": {
      "get": {
        "tags": [
          "抖音巨量星图"
        ],
        "summary": "创作者搜索",
        "description": "通过关键词和结构化筛选（包括受众、定价、内容、表现和活动匹配度）搜索抖音巨量星图创作者。用于构建和比较活动候选名单。",
        "operationId": "getApiDouyinXingtuGwApiGsearchSearchForAuthorSquareV1",
        "parameters": [
          {
            "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"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "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"
                    }
                  },
                  "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"
                    }
                  },
                  "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"
                    }
                  },
                  "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"
                    }
                  },
                  "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"
                    }
                  },
                  "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"
                    }
                  },
                  "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"
                    }
                  },
                  "required": [
                    "code",
                    "data",
                    "message",
                    "recordTime"
                  ]
                }
              }
            }
          }
        },
        "x-order": "15000010",
        "x-api-version": "v1",
        "x-search-aliases": [
          "Douyin Xingtu creator search",
          "Xingtu influencer discovery filters",
          "Douyin creator campaign shortlist",
          "抖音星图达人搜索",
          "星图达人筛选",
          "抖音达人投放名单"
        ],
        "x-highlights": [],
        "x-endpoint-family": "douyin_xingtu_gw_api_gsearch_search_for_author_square"
      }
    }
  }
}