--- title: "头条创作者搜索/Search Toutiao Creator" method: GET path: "/api/v1/douyin/xingtu_v2/search_toutiao_creator" tags: ["Douyin-Xingtu-V2-API"] --- # 头条创作者搜索/Search Toutiao Creator `GET /api/v1/douyin/xingtu_v2/search_toutiao_creator` ## 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_v2/search_toutiao_creator` - Auth: HTTP bearer # [中文] ### 用途: - 头条创作者搜索(头条图文广场)，按关键词搜索今日头条图文创作者，支持完整筛选条件 - 价格：0.002$ / 次 ### 参数: - keyword: 搜索关键词，可为创作者昵称、头条号或内容词 - page: 页码，默认1 - sort_field: 排序字段，默认`score`综合排序 - sort_type: 排序方式，1=升序，2=降序，默认2 - 合作诉求: task_category 合作对象、marketing_target 营销目标、first_industry_id 适配行业 - 匹配度: tag 达人类型、persona_tags 达人人设/学历/认证/调性、gender 性别、fans_min/fans_max 粉丝数 - 性价比: expected_play_min/expected_play_max 预期阅读量、 cpm_min/cpm_max 预期CPM、cpe_min/cpe_max 预期CPE、interact_rate_min/interact_rate_max 互动率、 play_over_rate_min/play_over_rate_max 完播率、burst_text_rate_min/burst_text_rate_max 爆文率 - 报价: price_type 固定为 `11`（头条图文报价）；price_min/price_max 为图文报价区间， 提供任一边界时必须同时提供 price_type - 主题推荐: author_list_id 达人清单ID - 画像筛选 extra_filter: 观众/粉丝画像、受众画像、所在地域、连接用户数等维度靠它筛选。 传 JSON 数组字符串，每个元素形如 `{"field_name":"字段名","field_value":"值"}`（可选 `rel_id`）， 常用字段： - 观众性别: `watcher_gender_female_rate_v2__ge`(女性占比阈值,取值 0.5/0.6/0.7/0.8), 男性用 `watcher_gender_male_rate_v2__ge` - 观众年龄: `watcher_age_most_new`(观众年龄居多,值为编码数组,如 `[22]`=24-30岁居多) 示例: `extra_filter=[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]` - 说明: tag/persona_tags 的可选ID可通过`get_author_market_fields`获取；动态画像字段和编码 可通过`get_search_field_options`获取；比率类参数为0-1小数(0.02=2%) ### 返回: - 头条创作者搜索结果数据（含创作者信息、报价、粉丝数、预期阅读量等） # [English] ### Purpose: - Search Toutiao image-text creators in the image-text marketplace by keyword, with full filtering - Price: 0.002$ / time ### Parameters: - keyword: Search keyword: nickname, Toutiao ID or content word - page: Page number, default 1 - sort_field: Sort field, default `score` (comprehensive sort) - sort_type: Sort type, 1=asc, 2=desc, default 2 - Cooperation: task_category, marketing_target, first_industry_id - Match: tag (category), persona_tags, gender, fans_min/fans_max - Cost-performance: expected_play_min/max, cpm_min/max, cpe_min/max, interact_rate_min/max, play_over_rate_min/max, burst_text_rate_min/max - Price: price_type is fixed to `11` for Toutiao image-text pricing; price_min/price_max define the price range and require price_type when either bound is supplied - Featured: author_list_id - Profile filters `extra_filter`: for audience/fans profile, region, connected-users, etc. Pass a JSON-array string; each element is `{"field_name":"...","field_value":"..."}` (optional `rel_id`), Common fields: - Audience gender: `watcher_gender_female_rate_v2__ge` (female-ratio threshold 0.5/0.6/0.7/0.8), male uses `watcher_gender_male_rate_v2__ge` - Audience age: `watcher_age_most_new` (dominant audience age, encoded array, e.g. `[22]`=24-30) Example: `extra_filter=[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]` - Note: valid IDs for tag/persona_tags come from `get_author_market_fields`; dynamic profile fields and codes come from `get_search_field_options`; rate params are 0-1 decimals (0.02=2%) ### Return: - Toutiao creator search result data (creator info, price, followers, expected reads, etc.) # [示例/Example] keyword = "数码" page = 1 gender = 2 fans_min = 10000 ## Query parameters - `keyword` string, required: 搜索关键词，可为创作者昵称、头条号或内容词/Search keyword: nickname, Toutiao ID or content word - `page` integer: 页码/Page number - `sort_field` string: 排序字段，默认score综合排序/Sort field, default score (comprehensive) - `sort_type` integer: 排序方式，1=升序，2=降序/Sort type, 1=asc, 2=desc - `task_category` integer: 合作对象/Cooperation target - `marketing_target` integer: 营销目标/Marketing target - `first_industry_id` integer, nullable: 适配行业ID/Industry ID - `author_list_id` string, nullable: 主题推荐达人清单ID/Featured creator list ID - `price_type` 11 - `price_min` integer, nullable: 图文报价下限，提供时必须同时提供price_type/Minimum image-text price - `price_max` integer, nullable: 图文报价上限，提供时必须同时提供price_type/Maximum image-text price - `tag` string, nullable: 达人类型ID，多个用逗号分隔，如`1,6`/Creator category IDs, comma-separated - `persona_tags` string, nullable: 达人人设/学历/认证/调性ID。逗号分隔=满足任一；分号分组=每组都要满足，如`1129,110401;110213`/Persona IDs. Comma=match any, semicolon=group AND - `gender` integer, nullable: 达人性别，1=男，2=女/Creator gender, 1=male, 2=female - `fans_min` integer, nullable: 粉丝数下限/Minimum followers - `fans_max` integer, nullable: 粉丝数上限/Maximum followers - `expected_play_min` integer, nullable: 预期播放量下限/Minimum expected plays - `expected_play_max` integer, nullable: 预期播放量上限/Maximum expected plays - `cpm_min` number, nullable: 预期CPM下限/Minimum expected CPM - `cpm_max` number, nullable: 预期CPM上限/Maximum expected CPM - `cpe_min` number, nullable: 预期CPE下限/Minimum expected CPE - `cpe_max` number, nullable: 预期CPE上限/Maximum expected CPE - `interact_rate_min` number, nullable: 互动率下限，0-1小数，0.02=2%/Minimum interaction rate, 0-1 decimal - `interact_rate_max` number, nullable: 互动率上限，0-1小数/Maximum interaction rate, 0-1 decimal - `play_over_rate_min` number, nullable: 完播率下限，0-1小数/Minimum play-completion rate, 0-1 decimal - `play_over_rate_max` number, nullable: 完播率上限，0-1小数/Maximum play-completion rate, 0-1 decimal - `burst_text_rate_min` number, nullable: 爆文率下限，0-1小数/Minimum viral-post rate, 0-1 decimal - `burst_text_rate_max` number, nullable: 爆文率上限，0-1小数/Maximum viral-post rate, 0-1 decimal - `extra_filter` string, nullable: 额外画像筛选的JSON数组字符串，每项必须包含非空字符串field_name和field_value；支持内容主题、观众/粉丝画像、八大人群和地域等维度/Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings ## 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-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`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/douyin/xingtu_v2/search_toutiao_creator/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)