Douyin-Xingtu-API

高级搜索kol V2/Search Kol Advanced V2

Changed on Nov 9, 2026

[中文]

用途:

高级搜索kol V2，支持粉丝范围和内容标签筛选
该接口数据使用企业账号进行请求，收费较贵。
价格：0.02$ / 次

参数:

keyword: 关键词
followerRange (可选): 粉丝范围，格式：最小值-最大值
- 例如：10-100 表示粉丝范围在 10万-100万之间
- 不传递此参数则不限制粉丝范围
contentTag (可选): 内容标签，支持以下格式:
- tag-{id}: 一级标签，例如 tag-1 (美妆)
- tag_level_two-{id}: 二级标签，例如 tag_level_two-7 (穿搭)
- 标签列表参考文档中的 contentTag 映射表
- 不传递此参数则不限制内容标签
以下为上游 2026-11-08 新增的可选筛选参数，全部不传时行为与原来完全一致:
- page: 页码
- sort: 排序方式
- searchType: 搜索类型
- marketingTarget: 营销目标
- industry: 所属行业
- isSuperstar: 是否明星
- kolPriceType / kolPriceRange: 报价类型 / 报价区间
- contentTheme: 内容主题
- personaTag: 人设标签
- gender: 达人性别
- location: 达人地域
- tonalityTag: 内容调性标签
- connectedUserRange: 连接人数区间
- audienceImage / fansImage: 观众画像 / 粉丝画像筛选
- expectedPlayRange / expectedCpmRange / expectedCpeRange: 预期播放 / CPM / CPE 区间
- interactionRateRange / completionRateRange / viralRateRange: 互动率 / 完播率 / 爆款率区间
- progressTaskRange: 在途任务数区间
- isCuratedAuthor: 是否精选达人
- authorList: 指定达人列表

kol列表（支持高级筛选）

[English]

Purpose:

Advanced Search Kol V2, supports follower range and content tag filtering
The interface data is requested using an enterprise account, which is more expensive.
Price: 0.02$ / time

Parameters:

keyword: Keyword
followerRange (optional): Follower range, format: min-max
- Example: 10-100 indicates follower range between 100,000 and 1,000,000
- Do not pass this parameter to not limit the follower range
contentTag (optional): Content tag, supports the following formats:
- tag-{id}: First-level tag, e.g., tag-1 (Beauty)
- tag_level_two-{id}: Second-level tag, e.g., tag_level_two-7 (Outfit)
- Refer to the contentTag mapping table in the documentation
- Do not pass this parameter to not limit content tags

Return:

Kol List (with advanced filtering)

[示例/Example]

keyword = "美妆" followerRange = "10-100" # 10万-100万粉丝 contentTag = "tag-1" # 美妆一级标签 contentTag = "tag_level_two-2" # 美妆教程二级标签

[内容标签映射表/Content Tag Mapping]

一级标签 (First-level tags) - 格式: tag-{id}

参数	分类	参数	分类	参数	分类
tag-1	美妆	tag-6	时尚	tag-11	萌宠
tag-15	测评	tag-23	游戏	tag-25	二次元
tag-27	旅行	tag-31	汽车	tag-36	生活
tag-41	音乐	tag-46	舞蹈*	tag-48	美食
tag-55	母婴亲子	tag-60	运动健身	tag-64	科技数码
tag-68	教育培训	tag-72	颜值达人	tag-79	才艺技能
tag-85	影视娱乐	tag-87	艺术文化	tag-91	财经投资
tag-95	三农*	tag-97	剧情搞笑	tag-100	情感*
tag-102	园艺*	tag-130	随拍*	tag-139	房产
tag-1001	生活家居	tag-1002	媒体号*

注: 标记的分类无二级标签

二级标签 (Second-level tags) - 格式: tag_level_two-{id}

美妆 (tag-1)

tag_level_two-2: 美妆教程
tag_level_two-3: 妆容展示
tag_level_two-4: 护肤保养
tag_level_two-5: 美妆测评种草

时尚 (tag-6)

tag_level_two-7: 穿搭
tag_level_two-8: 街拍
tag_level_two-10: 造型
tag_level_two-135: 时尚媒体

萌宠 (tag-11)

tag_level_two-12: 日常宠物
tag_level_two-13: 特别宠物
tag_level_two-14: 宠物周边

测评 (tag-15)

tag_level_two-16: 美妆测评
tag_level_two-17: 3C数码测评
tag_level_two-18: 汽车测评
tag_level_two-19: 美食产品测评
tag_level_two-20: 母婴产品测评
tag_level_two-21: 综合测评
tag_level_two-132: 酒店测评

游戏 (tag-23)

tag_level_two-121: 游戏剧情
tag_level_two-122: 游戏解说
tag_level_two-123: 游戏资讯
tag_level_two-124: 游戏其他
tag_level_two-440: 游戏录屏
tag_level_two-441: 游戏集锦

二次元 (tag-25)

tag_level_two-125: 二次元真人
tag_level_two-126: 动画漫画
tag_level_two-127: 配音声优
tag_level_two-128: 宅物手办

旅行 (tag-27)

tag_level_two-28: 旅行记录
tag_level_two-29: 旅行攻略
tag_level_two-30: 旅行推荐
tag_level_two-442: 户外生活

汽车 (tag-31)

tag_level_two-32: 汽车测评
tag_level_two-33: 汽车知识
tag_level_two-34: 汽车周边

生活 (tag-36)

tag_level_two-37: 生活记录
tag_level_two-39: 生活小窍门
tag_level_two-40: 好物推荐
tag_level_two-118: 健康养生
tag_level_two-422: 婚恋

音乐 (tag-41)

tag_level_two-42: 歌曲演唱
tag_level_two-43: 乐器演奏
tag_level_two-44: 音乐教学
tag_level_two-45: 音乐其他
tag_level_two-136: 音乐剪辑

美食 (tag-48)

tag_level_two-49: 美食教程
tag_level_two-50: 美食探店
tag_level_two-52: 美食产品测评
tag_level_two-53: 乡村野食
tag_level_two-54: 美食其他
tag_level_two-423: 酒类

母婴亲子 (tag-55)

tag_level_two-56: 育儿科普
tag_level_two-57: 萌娃日常
tag_level_two-58: 亲子互动
tag_level_two-59: 测评种草

科技数码 (tag-64)

tag_level_two-65: 3C数码
tag_level_two-66: 家居电器
tag_level_two-133: 科技

教育培训 (tag-68)

tag_level_two-69: 考学培训
tag_level_two-70: 语言教学
tag_level_two-71: 个人管理
tag_level_two-425: 职业教育

颜值达人 (tag-72)

tag_level_two-73: 美女
tag_level_two-74: 帅哥

才艺技能 (tag-79)

tag_level_two-80: 创意才能
tag_level_two-81: 手工
tag_level_two-82: 摄影
tag_level_two-83: 绘画
tag_level_two-84: 其他才艺

影视娱乐 (tag-85)

tag_level_two-413: 影视解说
tag_level_two-414: 影视混剪
tag_level_two-415: 明星资讯
tag_level_two-416: 综艺解说
tag_level_two-417: 综艺混剪

艺术文化 (tag-87)

tag_level_two-88: 传统文化
tag_level_two-89: 人文科普
tag_level_two-90: 自然科学

财经投资 (tag-91)

tag_level_two-92: 传统金融
tag_level_two-93: 互联网金融
tag_level_two-94: 财经知识

剧情搞笑 (tag-97)

tag_level_two-98: 剧情
tag_level_two-99: 搞笑

生活家居 (tag-1001)

tag_level_two-100101: 硬装
tag_level_two-100102: 软装
tag_level_two-100103: 生活技巧
tag_level_two-100104: 家居氛围

房产 (tag-139)

tag_level_two-140: 其他房产
tag_level_two-437: 房产知识
tag_level_two-439: 房产及投资
tag_level_two-448: 楼盘评测
tag_level_two-449: 楼市资讯
tag_level_two-450: 租房

get/api/v1/douyin/xingtu/search_kol_v2

Request

Base URL
https://api.tikhub.io (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer

Query parameters

keywordstring required

关键词/Keyword

followerRangestring

粉丝范围(可选)/Follower Range (optional), 例如 10-100 表示10万-100万粉丝

contentTagstring

内容标签(可选)/Content Tag (optional), 例如 tag-1 或 tag_level_two-7

pagestring

页码(可选)/Page (optional)

sortstring

排序方式(可选)/Sort order (optional)

searchTypestring

搜索类型(可选)/Search type (optional)

marketingTargetstring

营销目标(可选)/Marketing target (optional)

industrystring

所属行业(可选)/Industry (optional)

isSuperstarstring

是否明星(可选)/Whether superstar (optional)

kolPriceTypestring

报价类型(可选)/KOL price type (optional)

kolPriceRangestring

报价区间(可选)/KOL price range (optional)

contentThemestring

内容主题(可选)/Content theme (optional)

personaTagstring

人设标签(可选)/Persona tag (optional)

genderstring

达人性别(可选)/Author gender (optional)

locationstring

达人地域(可选)/Author location (optional)

tonalityTagstring

内容调性标签(可选)/Tonality tag (optional)

connectedUserRangestring

连接人数区间(可选)/Connected user range (optional)

audienceImagestring

观众画像筛选(可选)/Audience image (optional)

fansImagestring

粉丝画像筛选(可选)/Fans image (optional)

expectedPlayRangestring

预期播放区间(可选)/Expected play range (optional)

expectedCpmRangestring

预期CPM区间(可选)/Expected CPM range (optional)

expectedCpeRangestring

预期CPE区间(可选)/Expected CPE range (optional)

interactionRateRangestring

互动率区间(可选)/Interaction rate range (optional)

completionRateRangestring

完播率区间(可选)/Completion rate range (optional)

viralRateRangestring

爆款率区间(可选)/Viral rate range (optional)

progressTaskRangestring

在途任务数区间(可选)/In-progress task range (optional)

isCuratedAuthorstring

是否精选达人(可选)/Whether curated author (optional)

authorListstring

指定达人列表(可选)/Specific author list (optional)

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown

dataunknown

Changes

Nov 9, 2026cd87023a7e18 Revision changes
- info
  added the new optional query request parameter audienceImage
- info
  added the new optional query request parameter authorList
- info
  added the new optional query request parameter completionRateRange
- info
  added the new optional query request parameter connectedUserRange
- info
  added the new optional query request parameter contentTheme
- info
  added the new optional query request parameter expectedCpeRange
- info
  added the new optional query request parameter expectedCpmRange
- info
  added the new optional query request parameter expectedPlayRange
- info
  added the new optional query request parameter fansImage
- info
  added the new optional query request parameter gender
- info
  added the new optional query request parameter industry
- info
  added the new optional query request parameter interactionRateRange
- info
  added the new optional query request parameter isCuratedAuthor
- info
  added the new optional query request parameter isSuperstar
- info
  added the new optional query request parameter kolPriceRange
- info
  added the new optional query request parameter kolPriceType
- info
  added the new optional query request parameter location
- info
  added the new optional query request parameter marketingTarget
- info
  added the new optional query request parameter page
- info
  added the new optional query request parameter personaTag
- info
  added the new optional query request parameter progressTaskRange
- info
  added the new optional query request parameter searchType
- info
  added the new optional query request parameter sort
- info
  added the new optional query request parameter tonalityTag
- info
  added the new optional query request parameter viralRateRange
Oct 8, 202696a122a5f220 Revision changes
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history (4 revisions)

高级搜索kol V2/Search Kol Advanced V2

[中文]

用途:

参数:

返回:

[English]

Purpose:

Parameters:

Return:

[示例/Example]

[内容标签映射表/Content Tag Mapping]

一级标签 (First-level tags) - 格式: tag-{id}

二级标签 (Second-level tags) - 格式: tag_level_two-{id}

美妆 (tag-1)

时尚 (tag-6)

萌宠 (tag-11)

测评 (tag-15)

游戏 (tag-23)

二次元 (tag-25)

旅行 (tag-27)

汽车 (tag-31)

生活 (tag-36)

音乐 (tag-41)

美食 (tag-48)

母婴亲子 (tag-55)

运动健身 (tag-60)

科技数码 (tag-64)

教育培训 (tag-68)

颜值达人 (tag-72)

才艺技能 (tag-79)

影视娱乐 (tag-85)

艺术文化 (tag-87)

财经投资 (tag-91)

剧情搞笑 (tag-97)

生活家居 (tag-1001)

房产 (tag-139)

Request

Query parameters

Response

Changes

高级搜索kol V2/Search Kol Advanced V2

[中文]

用途:

参数:

返回:

[English]

Purpose:

Parameters:

Return:

[示例/Example]

[内容标签映射表/Content Tag Mapping]

一级标签 (First-level tags) - 格式: tag-{id}

二级标签 (Second-level tags) - 格式: tag_level_two-{id}

美妆 (tag-1)

时尚 (tag-6)

萌宠 (tag-11)

测评 (tag-15)

游戏 (tag-23)

二次元 (tag-25)

旅行 (tag-27)

汽车 (tag-31)

生活 (tag-36)

音乐 (tag-41)

美食 (tag-48)

母婴亲子 (tag-55)

运动健身 (tag-60)

科技数码 (tag-64)

教育培训 (tag-68)

颜值达人 (tag-72)

才艺技能 (tag-79)

影视娱乐 (tag-85)

艺术文化 (tag-87)

财经投资 (tag-91)

剧情搞笑 (tag-97)

生活家居 (tag-1001)

房产 (tag-139)

Request

Query parameters

Response 200OK

Changes

Response