--- title: "[已废弃]关键词搜索kol V1/[DEPRECATED]Search Kol V1" method: GET path: "/api/v1/douyin/xingtu/search_kol_v1" tags: ["Douyin-Xingtu-API"] deprecated: true --- # \[已废弃\]关键词搜索kol V1/\[DEPRECATED\]Search Kol V1 `GET /api/v1/douyin/xingtu/search_kol_v1` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/douyin/xingtu/search_kol_v1` - Auth: HTTP bearer > **Deprecated.** # [中文] ### ⚠️ 本接口已废弃: - 上游数据源已于 2026-11-08 下线该接口，请求会稳定失败。 - **请改用 `/api/v1/douyin/xingtu_v2/search_creator`（达人搜索）**，它完整覆盖本接口的能力， 并且价格更低（0.002$ / 次，本接口为 0.02$ / 次）。 - 参数对应关系: - `keyword` -> `keyword`（搜索词） - `page` -> `page`（页码） - 本接口按达人昵称匹配，对应新接口的 `seach_type=2`（默认值），无需额外传参 - `platformSource` 按平台分流到不同的新接口: - `_1` 抖音 -> `/api/v1/douyin/xingtu_v2/search_creator`（抖音短视频达人） - `_2` 头条 -> `/api/v1/douyin/xingtu_v2/search_toutiao_creator`（头条图文创作者） - `_3` 西瓜 -> 暂无对应接口 - 另外如需搜索抖音直播主播，可用 `/api/v1/douyin/xingtu_v2/search_anchor` - 新接口还额外支持按内容找人（`seach_type=3`）、排序、合作诉求、达人属性、效果指标、 报价区间、内容主题、观众画像等筛选条件。 - 本接口的路由与参数暂时保留不变，仅在上游恢复时才会继续工作。 ### 用途: - 关键词搜索kol V1 - 该接口数据使用企业账号进行请求，收费较贵。 - 价格：0.02$ / 次 ### 参数: - keyword: 关键词 - platformSource: - 平台来源，支持以下参数: - _1 :抖音(douyin) - _2 :头条(toutiao) - _3 :西瓜(xigua) - page: 页码，从1开始 ### 返回: - kol列表 # [English] ### ⚠️ DEPRECATED: - The upstream data source retired this endpoint on 2026-11-08; requests fail consistently. - **Use `/api/v1/douyin/xingtu_v2/search_creator` (Search Creator) instead.** It fully covers this endpoint's functionality at a lower price (0.002$ / time versus 0.02$ / time here). - Parameter mapping: - `keyword` -> `keyword` - `page` -> `page` - This endpoint matches creator nicknames, which corresponds to `seach_type=2` (the new endpoint's default), so nothing extra needs to be passed - `platformSource` maps to different new endpoints per platform: - `_1` Douyin -> `/api/v1/douyin/xingtu_v2/search_creator` (Douyin short-video creators) - `_2` Toutiao -> `/api/v1/douyin/xingtu_v2/search_toutiao_creator` (Toutiao article creators) - `_3` Xigua -> no equivalent endpoint yet - To search Douyin live-streaming anchors, use `/api/v1/douyin/xingtu_v2/search_anchor` - The new endpoint additionally supports searching by content (`seach_type=3`), sorting, cooperation requirements, creator attributes, performance metrics, price ranges, content themes and audience profiles. - This route and its parameters are kept unchanged for now, and will only work again if the upstream source is restored. ### Purpose: - Search Kol V1 - The interface data is requested using an enterprise account, which is more expensive. - Price: 0.02$ / time ### Parameters: - keyword: Keyword - platformSource: - Platform source, supports the following parameters: - _1 :Douyin - _2 :Toutiao - _3 :Xigua - page: Page number, starting from 1 ### Return: - Kol List # [示例/Example] keyword = "人工智能" platformSource = "_1" page = 1 ## Query parameters - `keyword` string, required: 关键词/Keyword - `platformSource` string, required: 平台来源/Platform Source - `page` integer, required: 页码/Page ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-11-09** `cd87023a7e18`: 1 info - endpoint deprecated - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 2 info - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.` for the status `200` - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200` - **2026-04-14** `ee5b7c9c88f5`: 11 info - added the optional property `cache_message` to the response with the `200` status - added the optional property `cache_message_zh` to the response with the `200` status - added the optional property `cache_url` to the response with the `200` status - added the optional property `docs` to the response with the `200` status - …7 more - **2025-01-19** `c85a1d22ae97`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/douyin/xingtu/search_kol_v1/get.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)