跳到主内容

GET /v1/douyin_xingtu/search/gsearch_for_author_square_v1

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

stable · 30 credits / 次（成功才计）

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

注册即送 500 credits，用自己的 Key 试调。 免费注册

请求

curl
curl -s 'https://api.wellbyte.net/v1/douyin_xingtu/search/gsearch_for_author_square_v1?page=1&sort=FANS&gender=MALE&keyword=%E5%92%96%E5%95%A1&industry=ALL&location=demo&fansImage=demo&authorList=SHORT_LIVE_ENTERTAINMENT_CREATORS&contentTag=demo&personaTag=demo&searchType=NICKNAME&isSuperstar=false&tonalityTag=demo&contentTheme=demo&kolPriceType=PRODUCT_PLACEMENT_VIDEO&audienceImage=demo&followerRange=demo&kolPriceRange=demo&viralRateRange=demo&isCuratedAuthor=false&marketingTarget=BRAND_EXPOSURE&expectedCpeRange=demo&expectedCpmRange=demo&expectedPlayRange=demo&progressTaskRange=demo&connectedUserRange=demo&completionRateRange=demo&interactionRateRange=demo' \
  -H "Authorization: Bearer dg_live_…"
免费注册

响应

示例采集于 2026-09-23

data{
code:0
data{
authors[ 2 items ]
base_resp{ 2 items }
extra_data{ 7 items }
pagination{ 4 items }
}
meta{
endpoint:"douyin_xingtu.search.gsearch_for_author_square_v1"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

请求历史

打开完整日志

还没有调用记录。先跑通一次，再换成你的数据。

    请求参数

    参数类型位置必填说明示例
    pageintegerquery否用于分页的页码。1
    sortstringquery否创作者搜索排序。可选值：FANS 按粉丝数降序排序，DEFAULT 使用星图评分排序。 可选值： - `DEFAULT`：平台默认评分排序 - `FANS`：按粉丝数降序排序FANS
    genderstringquery否创作者性别。可选值：MALE/1/男性, FEMALE/2/女性。 可选值： - `MALE`: 男性 - `FEMALE`: 女性MALE
    keywordstringquery否搜索关键词。咖啡
    industrystringquery否推荐行业筛选。传入枚举名称、数字行业ID或中文行业标签。可用值：- ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936…ALL
    locationstringquery否创作者地域筛选。传入中国省份或城市名称，多个用逗号分隔。可选省份值包括：北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省,…demo
    fansImagestringquery否粉丝画像筛选条件, 来自星图粉丝画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: GENDER_…demo
    authorListstringquery否星图话题推荐下的活动精选创作者列表。最多选择一个值。传入枚举名称、数字列表ID或中文标签。可选值：SHORT_LIVE_ENTERTAINMENT_CREATORS/7540478044453486642/短直联动娱播达人; SHORT_…SHORT_LIVE_ENTERTAINMENT_CREATORS
    contentTagstringquery否创作者分类筛选。传入星图一级或二级分类标签，多个用逗号分隔。可选值：- 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评:…demo
    personaTagstringquery否创作者人设或背景标签。传入星图标签或数字标签ID，多个用逗号分隔。可选值：- 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主…demo
    searchTypestringquery否搜索条件类型。 可用值： - `NICKNAME`: 按昵称 - `CONTENT`: 按内容NICKNAME
    isSuperstarbooleanquery否是否筛选达人创作者。false
    tonalityTagstringquery否创作者调性标签。传入星图一级或二级调性标签，多个用逗号分隔。可选值：- 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问,…demo
    contentThemestringquery否内容主题过滤。传入星图二级内容主题标签，用逗号分隔。仅接受冒号后列出的标签；冒号前的类别标题仅为描述性内容，不可传入。可用值包括： - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿…demo
    kolPriceTypestringquery否当前巨量星图市场选项中的创作者报价类型。 可用值： - `PRODUCT_PLACEMENT_VIDEO`: 产品植入视频 - `CUSTOM_VIDEO`: 定制视频 - `CUSTOM_SHORT_DRAMA_EPISODE`: 迷…PRODUCT_PLACEMENT_VIDEO
    audienceImagestringquery否受众画像筛选条件, 来自星图受众画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: GENDER_…demo
    followerRangestringquery否原始粉丝数量范围，格式为最小值-最大值。例如：1000-2000表示1000到2000个粉丝；5000000-10000000表示500万到1000万个粉丝。demo
    kolPriceRangestringquery否创作者报价范围，采用最小-最大格式（例如：10000-50000）。需要 kolPriceType；省略 kolPriceRange 以使用所选报价类型的完整范围。demo
    viralRateRangestringquery否爆文率范围，格式为小数最小值-最大值。页面预设包括0-0.1、0.1-0.25、0.25-0.5、0.5-0.99、0.99及以上。对于开放式预设，传入一个较大的上限，如0.99-1。示例：0.1-0.25。demo
    isCuratedAuthorbooleanquery否是否仅包含话题推荐下的星图精选创作者。false
    marketingTargetstringquery否营销目标。可选值：BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化。 可选值： - `BRAND_EXPOSURE`: 品牌曝光 - `CIRC…BRAND_EXPOSURE
    expectedCpeRangestringquery否预期CPE范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000。demo
    expectedCpmRangestringquery否预期CPM范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000。demo
    expectedPlayRangestringquery否预期播放量范围。使用原始播放量，格式为最小值-最大值。页面预设包括10000000及以上、5000000-10000000、3000000-5000000、1000000-3000000、100000-1000000、0-100000。对…demo
    progressTaskRangestringquery否进行中任务数量范围。在天数和最小-最大范围之间放置冒号；省略任一边界以表示开放范围。示例：30:8-demo
    connectedUserRangestringquery否关联用户数范围。传入原始用户数，格式为最小值-最大值。示例：1000000-3000000demo
    completionRateRangestringquery否完播率范围，格式为小数最小值-最大值。示例值：0.1-1表示10%及以上，0.2-1表示20%及以上。demo
    interactionRateRangestringquery否互动率范围，格式为小数最小值-最大值。示例值：0.01-1表示1%及以上，0.02-1表示2%及以上。demo

    响应字段

    字段字典待补 —— 右侧可执行区可直接看到真实结构。

    错误码

    codeHTTP含义是否计费
    40001400参数缺失或格式错误否
    40102401API Key 无效或已吊销否
    40201402余额不足，请充值否
    40402404目标资源不存在否
    42201422质量门槛未通过否
    42901429超出速率限制否
    50401504上游超时否
    50201502上游返回异常否

    计费

    成功扣 30 credits；任何失败（含返回 200 但未过质量门槛）扣 0。

    更多抖音巨量星图端点

    全部抖音巨量星图端点 →

    搜索

    搜索端点与文档