提供主播昵称，或“游戏”“美食”等直播内容关键词，查找抖音星图主播。需要筛选粉丝数量时，直接告诉 AI 想要的范围。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Douyin
提供主播昵称，或“游戏”“美食”等直播内容关键词，查找抖音星图主播。需要筛选粉丝数量时，直接告诉 AI 想要的范围。
获得符合搜索条件的一页星图主播结果。AI 可以把返回的主播资料、直播报价和观看数据整理成易读清单，方便你比较候选主播。
请在抖音星图查找[主播昵称或直播内容关键词]，先查看第一页，把返回的主播资料、直播报价和观看数据整理成易读的候选清单。
搜索结果按页查询，先查看第一页。想继续浏览时，告诉 AI 查看下一页。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
搜索条件queryParams | object | 必填 | 必填参数对象，包含 keyword 和本次选用的筛选条件。
|
达人分类 IDqueryParams.tag | string | null | 选填 | 供应方支持的达人分类 ID，多个用逗号分隔，例如 1,6。
|
结果页码queryParams.page | integer | 选填 | 本次要查询的页码，默认第 1 页。
|
主播性别queryParams.gender | integer | null | 选填 | 供应方编码：1 表示男，2 表示女。
|
预期互动成本上限（CPE）queryParams.cpe_max | number | null | 选填 | 用于筛选的预期每次互动成本上限。
|
预期互动成本下限（CPE）queryParams.cpe_min | number | null | 选填 | 用于筛选的预期每次互动成本下限。
|
预期千次观看成本上限（CPM）queryParams.cpm_max | number | null | 选填 | 用于筛选的预期千次观看成本上限。
|
预期千次观看成本下限（CPM）queryParams.cpm_min | number | null | 选填 | 用于筛选的预期千次观看成本下限。
|
搜索词queryParams.keyword | string | 必填 | 必填，可填写主播昵称、抖音号、星图 ID 或直播内容关键词。
|
粉丝数上限queryParams.fans_max | integer | null | 选填 | 匹配主播的粉丝数量上限。
|
粉丝数下限queryParams.fans_min | integer | null | 选填 | 匹配主播的粉丝数量下限。
|
直播报价上限queryParams.price_max | integer | null | 选填 | 非负整数报价上限；必须同时填写 price_type=9。
|
直播报价下限queryParams.price_min | integer | null | 选填 | 非负整数报价下限；必须同时填写 price_type=9。
|
排序方向queryParams.sort_type | integer | 选填 | 1 表示升序，2 表示降序；默认 2。
|
直播报价类型queryParams.price_type | integer | null | 选填 | 直播报价固定填 9。填写 price_min 或 price_max 时，必须同时填写本项。
|
排序字段queryParams.sort_field | string | 选填 | 默认 score，表示综合排序。
|
额外画像筛选queryParams.extra_filter | string | null | 选填 | 供应方支持的画像条件组成的 JSON 数组字符串。每项须包含非空字符串 field_name 和 field_value，使用已确认的画像字段与编码。
|
人设与认证等 IDqueryParams.persona_tags | string | null | 选填 | 供应方的人设、学历、认证或调性 ID。逗号分隔表示满足任一，分号分组表示每组都须满足。
|
合作对象编号queryParams.task_category | integer | 选填 | 供应方的合作对象编号，默认 6。
|
主题推荐达人清单 IDqueryParams.author_list_id | string | null | 选填 | 填写已知的主题推荐达人清单 ID。 |
营销目标编号queryParams.marketing_target | integer | 选填 | 供应方的营销目标编号，默认 3。
|
预期播放量上限queryParams.expected_play_max | integer | null | 选填 | 用于筛选候选主播的预期播放量上限；预期数值属于估计。
|
预期播放量下限queryParams.expected_play_min | integer | null | 选填 | 用于筛选候选主播的预期播放量下限；预期数值属于估计。
|
行业编号queryParams.first_industry_id | integer | null | 选填 | 填写供应方支持的行业编号，缩小搜索范围。 |
互动率上限queryParams.interact_rate_max | number | null | 选填 | 0–1 小数表示的互动率上限。
|
互动率下限queryParams.interact_rate_min | number | null | 选填 | 0–1 小数表示的互动率下限，例如 0.02 表示 2%。
|
完播率上限queryParams.play_over_rate_max | number | null | 选填 | 0–1 小数表示的视频完播率上限。
|
完播率下限queryParams.play_over_rate_min | number | null | 选填 | 0–1 小数表示的视频完播率下限。
|
爆文率上限queryParams.burst_text_rate_max | number | null | 选填 | 0–1 小数表示的爆文率上限。
|
爆文率下限queryParams.burst_text_rate_min | number | null | 选填 | 0–1 小数表示的爆文率下限。
|
{
"type": "object",
"required": [
"queryParams"
],
"properties": {
"queryParams": {
"type": "object",
"required": [
"keyword"
],
"properties": {
"tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tag",
"examples": [
"1"
],
"description": "创作者分类 ID，使用逗号分隔。"
},
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"examples": [
1
],
"description": "页码。"
},
"gender": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Gender",
"examples": [
2
],
"description": "创作者性别：1=男性，2=女性。"
},
"cpe_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Cpe Max",
"examples": [
5
],
"description": "预期 CPE 最大值。"
},
"cpe_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Cpe Min",
"examples": [
0.1
],
"description": "预期 CPE 最小值。"
},
"cpm_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Cpm Max",
"examples": [
100
],
"description": "预期 CPM 最大值。"
},
"cpm_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Cpm Min",
"examples": [
10
],
"description": "预期 CPM 最小值。"
},
"keyword": {
"type": "string",
"title": "Keyword",
"examples": [
"游戏"
],
"description": "搜索关键词：昵称、抖音号、星图 ID 或直播内容关键词。"
},
"fans_max": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Fans Max",
"examples": [
1000000
],
"description": "粉丝数最大值。"
},
"fans_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Fans Min",
"examples": [
10000
],
"description": "粉丝数最小值。"
},
"price_max": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Price Max",
"examples": [
100000
],
"description": "主播报价最大值。"
},
"price_min": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Price Min",
"examples": [
1000
],
"description": "主播报价最小值。"
},
"sort_type": {
"type": "integer",
"title": "Sort Type",
"default": 2,
"examples": [
2
],
"description": "排序类型：1=升序，2=降序。"
},
"price_type": {
"anyOf": [
{
"enum": [
9
],
"type": "integer",
"title": "XingtuAnchorPriceType",
"x-readme-ref-name": "XingtuAnchorPriceType"
},
{
"type": "null"
}
],
"title": "Price Type",
"examples": [
9
],
"description": "直播报价类型，固定为 9；与 price_min、price_max 配合使用。"
},
"sort_field": {
"type": "string",
"title": "Sort Field",
"default": "score",
"examples": [
"score"
],
"description": "排序字段，默认按综合评分。"
},
"extra_filter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Extra Filter",
"examples": [
"[{\"field_name\":\"content_theme_labels_180d\",\"field_value\":\"[\\\"生活好物评测\\\"]\"},{\"field_name\":\"watcher_gender_female_rate_v2__ge\",\"field_value\":\"0.6\"},{\"field_name\":\"link_crowd_profile\",\"field_value\":\"[60,55,53,57]\"}]"
],
"description": "额外画像筛选条件，使用 JSON 数组字符串；每项必须包含非空的 field_name 和 field_value。"
},
"persona_tags": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Persona Tags",
"examples": [
"1129,110401"
],
"description": "达人标签、人设、学历、认证或调性 ID。逗号表示满足任一条件，分号分组表示每组都要满足。"
},
"task_category": {
"type": "integer",
"title": "Task Category",
"default": 6,
"examples": [
6
],
"description": "合作目标。"
},
"author_list_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Author List Id",
"description": "精选创作者列表 ID。"
},
"marketing_target": {
"type": "integer",
"title": "Marketing Target",
"default": 3,
"examples": [
3
],
"description": "营销目标。"
},
"expected_play_max": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Expected Play Max",
"examples": [
1000000
],
"description": "预期播放量最大值。"
},
"expected_play_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Expected Play Min",
"examples": [
100000
],
"description": "预期播放量最小值。"
},
"first_industry_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "First Industry Id",
"description": "行业 ID。"
},
"interact_rate_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Interact Rate Max",
"examples": [
0.5
],
"description": "互动率最大值，取 0-1 之间的小数。"
},
"interact_rate_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Interact Rate Min",
"examples": [
0.02
],
"description": "互动率最小值，取 0-1 之间的小数。"
},
"play_over_rate_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Play Over Rate Max",
"examples": [
0.9
],
"description": "完播率最大值，取 0-1 之间的小数。"
},
"play_over_rate_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Play Over Rate Min",
"examples": [
0.05
],
"description": "完播率最小值，取 0-1 之间的小数。"
},
"burst_text_rate_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Burst Text Rate Max",
"examples": [
0.8
],
"description": "爆款作品率最大值，取 0-1 之间的小数。"
},
"burst_text_rate_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Burst Text Rate Min",
"examples": [
0.1
],
"description": "爆款作品率最小值，取 0-1 之间的小数。"
}
},
"additionalProperties": true
}
},
"additionalProperties": false
}暂未配置返回字段说明。
不知道主播的准确昵称时，可以用“游戏”“美食”等直播内容关键词开始搜索。需要筛选粉丝数量时，直接告诉 AI 最少或最多多少粉丝即可。
告诉 AI 想查找的主播昵称，或游戏、美食等直播内容关键词。需要筛选粉丝数量时，用普通说法补充最少或最多多少粉丝。
请在抖音星图查找[主播昵称或直播内容关键词]，先查看第一页，把返回的主播资料、直播报价和观看数据整理成易读的候选清单。
查看 AI 整理的主播资料、报价和观看数据。想浏览更多结果时，告诉它查看下一页。
