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

GET

接口健康状态

健康 可用 少量可用 基本不可用 暂无数据

正在加载健康状态…

获取抖音巨量星图创作者搜索数据，包括筛选条件、返回资料和受众信息，用于发现、比较和建立候选名单。

请求参数

参数名	位置	类型	必填	默认值	说明
token	query	string	是	-	用户鉴权令牌。
keyword	query	string	否	``	搜索关键词。
page	query	integer	否	1	用于分页的页码。
sort	query	string	否	FANS	创作者搜索排序。可选值：FANS 按粉丝数降序排序，DEFAULT 使用星图评分排序。 可选值： - DEFAULT：平台默认评分排序 - FANS：按粉丝数降序排序
searchType	query	string	否	NICKNAME	搜索条件类型。 可用值： - NICKNAME: 按昵称 - CONTENT: 按内容
marketingTarget	query	string	否	-	营销目标。可选值：BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化。 可选值： - BRAND_EXPOSURE: 品牌曝光 - CIRCLE_SEEDING: 破圈种草 - ACTION_CONVERSION: 行动转化
industry	query	string	否	ALL	推荐行业筛选。传入枚举名称、数字行业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	boolean	否	false	是否筛选达人创作者。
followerRange	query	string	否	-	粉丝数量范围（例如：10-100）。
kolPriceType	query	string	否	-	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	string	否	-	KOL 价格范围（例如：10000-50000）。
contentTag	query	string	否	-	创作者分类筛选。传入星图一级或二级分类标签，多个用逗号分隔。可选值：- 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次元: 二次元真人, 动画漫画, 配音声优, 宅物手办; - 旅行: 旅行记录, 旅行攻略, 旅行推荐, 户外生活; - 汽车: 汽车测评, 汽车知识, 汽车周边; - 生活: 生活记录, 生活小窍门, 好物推荐, 健康养生, 婚恋; - 音乐: 歌曲演唱, 乐器演奏, 音乐教学, 音乐其他, 音乐剪辑; - 舞蹈; - 美食: 美食教程, 美食探店, 美食产品测评, 乡村野食, 美食其他, 酒类; - 母婴亲子: 育儿科普, 萌娃日常, 亲子互动, 测评种草; - 运动健身: 健身, 极限运动, 体育资讯, 冰雪, 垂钓, 格斗, 球类项目, 综合体育; - 科技数码: 3C数码, 家居电器, 科技; - 教育培训: 考学培训, 语言教学, 个人管理, 职业教育; - 颜值达人: 美女, 帅哥; - 生活家居: 硬装, 软装, 生活技巧, 家居氛围; - 才艺技能: 创意才能, 手工, 摄影, 绘画, 其他才艺; - 影视娱乐: 影视解说, 影视混剪, 明星资讯, 综艺解说, 综艺混剪; - 艺术文化: 传统文化, 人文科普, 自然科学; - 财经投资: 传统金融, 互联网金融, 财经知识; - 三农; - 剧情搞笑: 剧情, 搞笑; - 情感; - 园艺; - 房产: 其他房产, 房产知识, 房产及投资, 楼盘评测, 楼市资讯, 租房; - 随拍; - 媒体号。示例：美妆,穿搭,剧情搞笑 示例： - 美妆,穿搭,剧情搞笑
contentTheme	query	string	否	-	内容主题筛选。传入星图二级内容主题标签，多个用逗号分隔。可选值包括：- 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常菜谱, 美食探店, 零食测评, 酒水品鉴, 厨房用品, 海鲜烹饪, 减脂美食; - 精彩车生活: 汽车行业资讯, 用车知识, 车辆保养, 自驾旅行, 新能源汽车资讯, 汽车用品测评, SUV测评; - 手机/数码/家电分享: 科技科普, 电子产品测评, 家电推荐, 手机评测, 智能家居, AI应用, 数码开箱; - 剧情演绎: 搞笑剧情, 剧情反转, 情感演绎, 家庭幽默演绎, 职场趣闻, 古风剧情, 生存挑战; - 萌宠养护: 宠物狗故事, 动物萌态, 宠物养护, 猫咪萌态, 宠物健康, 宠物护理, 宠物救助; - 旅行攻略: 国内旅行, 海外旅行, 城市旅行攻略, 酒店体验, 露营体验, 亲子旅行, 网红景点种草; - 家居好物: 清洁技巧, 生活好物评测, 家居选购, 家居装修, 家居收纳, 家装避坑, 房间布置; - 运动户外: 户外运动, 健身塑形, 赛事回顾, 体重管理, 极限运动, 跑步健身, 户外露营。示例：亲子活动,宝宝辅食 示例： - 亲子活动,宝宝辅食
personaTag	query	string	否	-	创作者人设或背景标签。传入星图标签或数字标签ID，多个用逗号分隔。可选值：- 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白, 抗老, 祛皱, 抗炎, 修复, 控油, 眼部护理, 补水保湿, 祛斑, 祛痘祛闭口, 隔离防晒; - 母婴阶段: 孕期, 0-6月, 7-12月, 1-3岁, 3-6岁, 6-12岁, 12-15岁, 15-18岁; - 爱好: 摄影, 时尚穿搭, 美食制作, 科普, 星座, 绘画; - 职业: 法律从业者, 航空业从业者, 健身/舞蹈教练, 专业美食从业者, 室内设计师; - 学历: 大学生, 硕士生, 博士, 留学生; - 黄v认证: 美妆创作者, 体育创作者, 媒体人/主持人, 科技创作者, 运动员; - 其他标签: 潮流运动, 球类, 非球类, 室内健身, 城市运动, 户外运动, 数码潮流玩家, 户外爱好者, 室内设计师, 品酒家/调酒师, 美食评论人, 母婴行业专家, 奶爸, 旧屋改造, 装修设计, 收纳, 新生儿妈妈, 孕妈, 时尚妈妈, 二三胎妈妈, 西餐, 火锅, 国风爱好者, 成分党。示例：大学生,美妆创作者 示例： - 大学生,美妆创作者
gender	query	string	否	-	创作者性别。可选值：MALE/1/男性, FEMALE/2/女性。 可选值： - MALE: 男性 - FEMALE: 女性
location	query	string	否	-	创作者地域筛选。传入中国省份或城市名称，多个用逗号分隔。可选省份值包括：北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别行政区, 澳门特别行政区。示例：广东省,深圳市 示例： - 广东省,深圳市
tonalityTag	query	string	否	-	创作者调性标签。传入星图一级或二级调性标签，多个用逗号分隔。可选值：- 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球。示例：精致达人,设计师 示例： - 精致达人,设计师
connectedUserRange	query	string	否	-	关联用户数范围。传入原始用户数，格式为最小值-最大值。示例：1000000-3000000 示例： - 1000000-3000000
audienceImage	query	string	否	-	来自星图受众画像的受众画像筛选器。传入一个或多个用逗号分隔的快捷值。可用值：- 性别：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 示例： - GENDER_FEMALE_50,CROWD_REFINED_MOTHER
fansImage	query	string	否	-	来自星图粉丝画像的粉丝画像筛选器。传入一个或多个用逗号分隔的快捷值。可用值：- 性别：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 示例： - GENDER_FEMALE_50,CROWD_REFINED_MOTHER
expectedPlayRange	query	string	否	-	预期播放量范围。使用原始播放量，格式为最小值-最大值。页面预设包括10000000及以上、5000000-10000000、3000000-5000000、1000000-3000000、100000-1000000、0-100000。对于开放式预设，传入一个较大的上限，如10000000-1000000000。示例：1000000-3000000。 示例： - 1000000-3000000
expectedCpmRange	query	string	否	-	预期CPM范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000。 示例： - 0-10
expectedCpeRange	query	string	否	-	预期CPE范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000。 示例： - 0-1
interactionRateRange	query	string	否	-	互动率范围，格式为小数最小值-最大值。示例值：0.01-1表示1%及以上，0.02-1表示2%及以上。 示例： - 0.01-1
completionRateRange	query	string	否	-	完播率范围，格式为小数最小值-最大值。示例值：0.1-1表示10%及以上，0.2-1表示20%及以上。 示例： - 0.1-1
viralRateRange	query	string	否	-	爆文率范围，格式为小数最小值-最大值。页面预设包括0-0.1、0.1-0.25、0.25-0.5、0.5-0.99、0.99及以上。对于开放式预设，传入一个较大的上限，如0.99-1。示例：0.1-0.25。 示例： - 0.1-0.25
progressTaskRange	query	string	否	-	进行中任务数范围。格式为天数:最小值-最大值。使用开放式范围时，格式为天数:最小值-或天数:-最大值。示例：30:8- 示例： - 30:8-

代码示例

💡 环境说明

默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。

🐚 cURL

curl -X GET "https://api.justoneapi.com/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY"

🤖 AI 提示词

我想使用 Just One API 提供的“创作者搜索 (V1)”接口。
接入地址: 默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。
接口路径: /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): 粉丝数量范围（例如：10-100）。
- 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-

返回格式: 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"  # 大陆用户可改为 "http://47.117.133.51:30015"

url = BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY"
response = requests.get(url)
print(response.json())

🌐 JavaScript

const BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
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"
});
const data = await response.json();
console.log(data);

☕ Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
        final String url = BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

🐹 Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

const BASE_URL = "https://api.justoneapi.com" // 大陆用户可改为 "http://47.117.133.51:30015"

func main() {
	client := &http.Client{}
	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()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

🐘 PHP

<?php
$BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
$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_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;

[OpenAPI 定义 (JSON)]

响应结果示例

正在加载最新成功示例…