GET /v1/douyin_xingtu/search/gsearch_for_author_square_v1
Douyin Xingtu Creator Search API (V1)
stable · 30 credits per success
Search Xingtu creators by keyword and structured filters covering audience, pricing, content, performance and campaign fit. Use it to build and compare campaign shortlists.
Request parameters
| Name | Type | In | Required | Description | Example |
|---|---|---|---|---|---|
| page | integer | query | no | 用于分页的页码。 | 1 |
| sort | string | query | no | 创作者搜索排序。可选值：FANS 按粉丝数降序排序，DEFAULT 使用星图评分排序。 可选值： - `DEFAULT`：平台默认评分排序 - `FANS`：按粉丝数降序排序 | FANS |
| gender | string | query | no | 创作者性别。可选值：MALE/1/男性, FEMALE/2/女性。 可选值： - `MALE`: 男性 - `FEMALE`: 女性 | MALE |
| keyword | string | query | no | 搜索关键词。 | 咖啡 |
| industry | string | query | no | 推荐行业筛选。传入枚举名称、数字行业ID或中文行业标签。可用值：- ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936… | ALL |
| location | string | query | no | 创作者地域筛选。传入中国省份或城市名称，多个用逗号分隔。可选省份值包括：北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省,… | demo |
| fansImage | string | query | no | 粉丝画像筛选条件, 来自星图粉丝画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: GENDER_… | demo |
| authorList | string | query | no | 星图话题推荐下的活动精选创作者列表。最多选择一个值。传入枚举名称、数字列表ID或中文标签。可选值：SHORT_LIVE_ENTERTAINMENT_CREATORS/7540478044453486642/短直联动娱播达人; SHORT_… | SHORT_LIVE_ENTERTAINMENT_CREATORS |
| contentTag | string | query | no | 创作者分类筛选。传入星图一级或二级分类标签，多个用逗号分隔。可选值：- 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评:… | demo |
| personaTag | string | query | no | 创作者人设或背景标签。传入星图标签或数字标签ID，多个用逗号分隔。可选值：- 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主… | demo |
| searchType | string | query | no | 搜索条件类型。 可用值： - `NICKNAME`: 按昵称 - `CONTENT`: 按内容 | NICKNAME |
| isSuperstar | boolean | query | no | 是否筛选达人创作者。 | false |
| tonalityTag | string | query | no | 创作者调性标签。传入星图一级或二级调性标签，多个用逗号分隔。可选值：- 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问,… | demo |
| contentTheme | string | query | no | 内容主题过滤。传入星图二级内容主题标签，用逗号分隔。仅接受冒号后列出的标签；冒号前的类别标题仅为描述性内容，不可传入。可用值包括： - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿… | demo |
| kolPriceType | string | query | no | 当前巨量星图市场选项中的创作者报价类型。 可用值： - `PRODUCT_PLACEMENT_VIDEO`: 产品植入视频 - `CUSTOM_VIDEO`: 定制视频 - `CUSTOM_SHORT_DRAMA_EPISODE`: 迷… | PRODUCT_PLACEMENT_VIDEO |
| audienceImage | string | query | no | 受众画像筛选条件, 来自星图受众画像. 传递一个或多个逗号分隔的快捷值. 只接受以下列出的值. 对于性别阈值, 最多传递一个 GENDER_MALE_* 值和一个 GENDER_FEMALE_* 值. 可用值: - 性别: GENDER_… | demo |
| followerRange | string | query | no | 原始粉丝数量范围，格式为最小值-最大值。例如：1000-2000表示1000到2000个粉丝；5000000-10000000表示500万到1000万个粉丝。 | demo |
| kolPriceRange | string | query | no | 创作者报价范围，采用最小-最大格式（例如：10000-50000）。需要 kolPriceType；省略 kolPriceRange 以使用所选报价类型的完整范围。 | demo |
| viralRateRange | string | query | no | 爆文率范围，格式为小数最小值-最大值。页面预设包括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 |
| isCuratedAuthor | boolean | query | no | 是否仅包含话题推荐下的星图精选创作者。 | false |
| marketingTarget | string | query | no | 营销目标。可选值：BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化。 可选值： - `BRAND_EXPOSURE`: 品牌曝光 - `CIRC… | BRAND_EXPOSURE |
| expectedCpeRange | string | query | no | 预期CPE范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000。 | demo |
| expectedCpmRange | string | query | no | 预期CPM范围，格式为最小值-最大值。与星图套餐匹配的示例值：0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000。 | demo |
| expectedPlayRange | string | query | no | 预期播放量范围。使用原始播放量，格式为最小值-最大值。页面预设包括10000000及以上、5000000-10000000、3000000-5000000、1000000-3000000、100000-1000000、0-100000。对… | demo |
| progressTaskRange | string | query | no | 进行中任务数量范围。在天数和最小-最大范围之间放置冒号；省略任一边界以表示开放范围。示例：30:8- | demo |
| connectedUserRange | string | query | no | 关联用户数范围。传入原始用户数，格式为最小值-最大值。示例：1000000-3000000 | demo |
| completionRateRange | string | query | no | 完播率范围，格式为小数最小值-最大值。示例值：0.1-1表示10%及以上，0.2-1表示20%及以上。 | demo |
| interactionRateRange | string | query | no | 互动率范围，格式为小数最小值-最大值。示例值：0.01-1表示1%及以上，0.02-1表示2%及以上。 | demo |
Response fields
Field dictionary coming soon — the executable panel shows the live shape.
Errors
| code | HTTP | Meaning | Billed |
|---|---|---|---|
| 40001 | 400 | Invalid parameters | no |
| 40102 | 401 | Invalid or revoked API Key | no |
| 40201 | 402 | Insufficient credits | no |
| 40402 | 404 | Resource not found | no |
| 42201 | 422 | Quality gate failed | no |
| 42901 | 429 | Rate limit exceeded | no |
| 50401 | 504 | Upstream timeout | no |
| 50201 | 502 | Upstream error | no |
Billing
Success costs 30 credits. Any failure — including a 200 that fails the quality gate — costs 0.