Skip to content

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

GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

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

请求参数

参数名位置类型必填默认值说明
tokenquerystring-用户鉴权令牌。
keywordquerystring搜索关键词。
pagequeryinteger1用于分页的页码。
sortquerystringFANS创作者搜索排序。可选值:FANS 按粉丝数降序排序,DEFAULT 使用星图评分排序。


可选值:

- DEFAULT:平台默认评分排序

- FANS:按粉丝数降序排序
searchTypequerystringNICKNAME搜索条件类型。


可用值:

- NICKNAME: 按昵称

- CONTENT: 按内容
marketingTargetquerystring-营销目标。可选值:BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化。


可选值:

- BRAND_EXPOSURE: 品牌曝光

- CIRCLE_SEEDING: 破圈种草

- ACTION_CONVERSION: 行动转化
industryquerystringALL推荐行业筛选。传入枚举名称、数字行业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:运动户外
isSuperstarquerybooleanfalse是否筛选达人创作者。
followerRangequerystring-原始粉丝数量范围,格式为最小值-最大值。例如:1000-2000表示1000到2000个粉丝;5000000-10000000表示500万到1000万个粉丝。
kolPriceTypequerystring-KOL价格类型。


可选值:

- VIDEO_1_20S: 视频1-20秒

- VIDEO_21_60S: 视频21-60秒

- VIDEO_OVER_60S: 视频60秒以上

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


可选值:

- MALE: 男性

- FEMALE: 女性
locationquerystring-创作者地域筛选。传入中国省份或城市名称,多个用逗号分隔。可选省份值包括:北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别行政区, 澳门特别行政区。示例:广东省,深圳市
tonalityTagquerystring-创作者调性标签。传入星图一级或二级调性标签,多个用逗号分隔。可选值:- 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球。示例:精致达人,设计师
connectedUserRangequerystring-关联用户数范围。传入原始用户数,格式为最小值-最大值。示例:1000000-3000000
audienceImagequerystring-来自星图受众画像的受众画像筛选器。传入一个或多个用逗号分隔的快捷值。可用值:- 性别: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 小镇青年)。示例:GENDER_FEMALE_50,CROWD_REFINED_MOTHER
fansImagequerystring-来自星图粉丝画像的粉丝画像筛选器。传入一个或多个用逗号分隔的快捷值。可用值:- 性别: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 小镇青年)。示例:GENDER_FEMALE_50,CROWD_REFINED_MOTHER
expectedPlayRangequerystring-预期播放量范围。使用原始播放量,格式为最小值-最大值。页面预设包括10000000及以上、5000000-10000000、3000000-5000000、1000000-3000000、100000-1000000、0-100000。对于开放式预设,传入一个较大的上限,如10000000-1000000000。示例:1000000-3000000。
expectedCpmRangequerystring-预期CPM范围,格式为最小值-最大值。与星图套餐匹配的示例值:0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000。
expectedCpeRangequerystring-预期CPE范围,格式为最小值-最大值。与星图套餐匹配的示例值:0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000。
interactionRateRangequerystring-互动率范围,格式为小数最小值-最大值。示例值:0.01-1表示1%及以上,0.02-1表示2%及以上。
completionRateRangequerystring-完播率范围,格式为小数最小值-最大值。示例值:0.1-1表示10%及以上,0.2-1表示20%及以上。
viralRateRangequerystring-爆文率范围,格式为小数最小值-最大值。页面预设包括0-0.1、0.1-0.25、0.25-0.5、0.5-0.99、0.99及以上。对于开放式预设,传入一个较大的上限,如0.99-1。示例:0.1-0.25。
progressTaskRangequerystring-进行中任务数量范围。在天数和最小-最大范围之间放置冒号;省略任一边界以表示开放范围。示例:30:8-
isCuratedAuthorquerybooleanfalse是否仅包含话题推荐下的星图精选创作者。
authorListquerystring-星图话题推荐下的活动精选创作者列表。最多选择一个值。传入枚举名称、数字列表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: 美妆质感达人

代码示例

bash
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
我想使用 Just One API 提供的“创作者搜索 (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): KOL价格类型。

可选值:
- `VIDEO_1_20S`: 视频1-20秒
- `VIDEO_21_60S`: 视频21-60秒
- `VIDEO_OVER_60S`: 视频60秒以上
- `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): KOL 价格范围(例如:10000-50000)。
- 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_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 小镇青年)。示例:GENDER_FEMALE_50,CROWD_REFINED_MOTHER
- fansImage (query): 来自星图粉丝画像的粉丝画像筛选器。传入一个或多个用逗号分隔的快捷值。可用值:- 性别: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 小镇青年)。示例: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
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
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
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
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
$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;
}

响应示例

正在加载响应示例…