# Douyin Xingtu creator search Search or filter Douyin short-video creators with keyword, cooperation, creator profile, performance, price, content-theme, and audience-profile filters. Takes keyword, seach type, time range days and more, all optional. Served by TikHub. Purpose: - Search or filter Douyin short-video creators with keyword, cooperation, creator profile, performance, price, content-theme, and audience-profile filters. - `keyword` may be empty for filter-only browsing. Basic search parameters: - `keyword`: Optional search term; nickname text for `seach_type=2`, content text for `seach_type=3`. Leave empty to use filters only. - `seach_type`: `2`=nickname (default), `3`=content. - `time_range_days`: Content range of `30`, `90`, or `180` days; only applies to content search. - `page`: Page number starting from 1. - `sort_field`: Sort field; default `score`. - `sort_type`: `1`=ascending, `2`=descending. Cooperation and match parameters: - `task_category`: Cooperation target or task category. - `marketing_target`: Marketing objective. - `first_industry_id`: First-level industry ID; `0` means unrestricted. - `author_list_id`: Featured creator-list ID. - `tag`: Creator-category IDs, comma-separated. - `persona_tags`: Persona/education/certification/style IDs. Commas mean OR within a group; semicolons separate groups that must all match. - `gender`: Creator gender, `1`=male, `2`=female. - `fans_min` / `fans_max`: Follower-count range. Performance and price parameters: - `expected_play_min` / `expected_play_max`: Expected-play range. - `cpm_min` / `cpm_max`: Expected cost-per-thousand-play range. - `cpe_min` / `cpe_max`: Expected cost-per-engagement range. - `interact_rate_min` / `interact_rate_max`: Interaction-rate range as 0-1 decimals. - `play_over_rate_min` / `play_over_rate_max`: Completion-rate range as 0-1 decimals. - - Tool ID: `tikhub/douyin-xingtu-v2-search-creator` - Name in the catalog: Douyin, Search Creator - Provider: [TikHub](/providers/tikhub.md) - Capability: [Xingtu creator marketplace](/tools/douyin/xingtu.md) - Price: $0.002 per call - Authentication: an authorised Agentik workspace is required for execution, including zero-price tools. ## Pricing contract The provider’s price, with no markup. Billed for measured usage. ```json { "model": "per_call", "amountUsd": 0.002 } ``` Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.002; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second. Price verification date: 2026-10-05. ## Complete input schema ```json { "type": "object", "properties": { "keyword": { "type": "string", "description": "可选搜索词；留空时仅按筛选条件浏览。seach_type=2匹配昵称，=3匹配内容/Optional keyword; empty means filter-only browsing", "default": "", "title": "Keyword" }, "seach_type": { "type": "integer", "enum": [ 2, 3 ], "title": "XingtuCreatorSearchType", "description": "搜索方式，2=按昵称找人，3=按内容找人/Search mode: 2=nickname, 3=content" }, "time_range_days": { "type": "integer", "enum": [ 30, 90, 180 ], "title": "XingtuContentSearchTimeRange", "description": "内容搜索时间范围，30/90/180天，仅seach_type=3时生效/Content time range; only for seach_type=3" }, "page": { "type": "integer", "description": "页码/Page number", "default": 1, "title": "Page" }, "sort_field": { "type": "string", "description": "排序字段，默认score综合排序/Sort field, default score (comprehensive)", "default": "score", "title": "Sort Field" }, "sort_type": { "type": "integer", "description": "排序方式，1=升序，2=降序/Sort type, 1=asc, 2=desc", "default": 2, "title": "Sort Type" }, "task_category": { "type": "integer", "description": "合作对象/Cooperation target", "default": 1, "title": "Task Category" }, "marketing_target": { "type": "integer", "description": "营销目标/Marketing target", "default": 1, "title": "Marketing Target" }, "first_industry_id": { "description": "适配行业ID，0=不限/Industry ID, 0=unlimited Use an exact decimal string for IDs beyond JavaScript's safe integer range.", "default": 0, "title": "First Industry Id", "anyOf": [ { "type": "integer", "maximum": 9007199254740991 }, { "type": "string", "pattern": "^[0-9]+$", "minLength": 1, "maxLength": 30 } ] }, "author_list_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "主题推荐达人清单ID/Featured creator list ID", "title": "Author List Id" }, "price_type": { "anyOf": [ { "type": "integer", "enum": [ 1, 2, 3 ], "title": "XingtuCreatorPriceType" }, { "type": "null" } ], "description": "短视频报价时长档位：1=1-20秒、2=21-60秒、3=60秒以上；仅与price_min/price_max配合使用/Creator video price tier", "title": "Price Type" }, "price_min": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "description": "达人报价下限，提供时必须同时提供price_type/Minimum creator price", "title": "Price Min" }, "price_max": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "description": "达人报价上限，提供时必须同时提供price_type/Maximum creator price", "title": "Price Max" }, "tag": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "达人类型ID，多个用逗号分隔，如`1,6`/Creator category IDs, comma-separated", "title": "Tag" }, "persona_tags": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "达人人设/学历/认证/调性ID。逗号分隔=满足任一；分号分组=每组都要满足，如`1129,110401;110213`/Persona IDs. Comma=match any, semicolon=group AND", "title": "Persona Tags" }, "gender": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "达人性别，1=男，2=女/Creator gender, 1=male, 2=female", "title": "Gender" }, "fans_min": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "粉丝数下限/Minimum followers", "title": "Fans Min" }, "fans_max": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "粉丝数上限/Maximum followers", "title": "Fans Max" }, "expected_play_min": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "预期播放量下限/Minimum expected plays", "title": "Expected Play Min" }, "expected_play_max": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "预期播放量上限/Maximum expected plays", "title": "Expected Play Max" }, "cpm_min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "预期CPM下限/Minimum expected CPM", "title": "Cpm Min" }, "cpm_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "预期CPM上限/Maximum expected CPM", "title": "Cpm Max" }, "cpe_min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "预期CPE下限/Minimum expected CPE", "title": "Cpe Min" }, "cpe_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "预期CPE上限/Maximum expected CPE", "title": "Cpe Max" }, "interact_rate_min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "互动率下限，0-1小数，0.02=2%/Minimum interaction rate, 0-1 decimal", "title": "Interact Rate Min" }, "interact_rate_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "互动率上限，0-1小数/Maximum interaction rate, 0-1 decimal", "title": "Interact Rate Max" }, "play_over_rate_min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "完播率下限，0-1小数/Minimum play-completion rate, 0-1 decimal", "title": "Play Over Rate Min" }, "play_over_rate_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "完播率上限，0-1小数/Maximum play-completion rate, 0-1 decimal", "title": "Play Over Rate Max" }, "burst_text_rate_min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "爆文率下限，0-1小数/Minimum viral-post rate, 0-1 decimal", "title": "Burst Text Rate Min" }, "burst_text_rate_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "爆文率上限，0-1小数/Maximum viral-post rate, 0-1 decimal", "title": "Burst Text Rate Max" }, "extra_filter": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "额外画像筛选的JSON数组字符串，每项必须包含非空字符串field_name和field_value；支持内容主题、观众/粉丝画像、八大人群和地域等维度/Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings", "title": "Extra Filter" } }, "additionalProperties": false } ``` ## Published example This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection. ```json { "tool_id": "tikhub/douyin-xingtu-v2-search-creator", "input": { "keyword": "健身", "seach_type": 2, "time_range_days": 180, "page": 1, "sort_field": "score", "sort_type": 2, "task_category": 1, "marketing_target": 1, "first_industry_id": 0, "price_type": 2, "price_min": 1000, "price_max": 100000, "tag": "1", "persona_tags": "1129,110401", "gender": 2, "fans_min": 10000, "fans_max": 1000000, "expected_play_min": 100000, "expected_play_max": 1000000, "cpm_min": 10, "cpm_max": 100, "cpe_min": 0.1, "cpe_max": 5, "interact_rate_min": 0.02, "interact_rate_max": 0.5, "play_over_rate_min": 0.05, "play_over_rate_max": 0.9, "burst_text_rate_min": 0.1, "burst_text_rate_max": 0.8, "extra_filter": "[{\"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]\"}]" } } ``` ## Execute and retrieve Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative. A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md). [Provider documentation](https://api.tikhub.io/#/Douyin-Xingtu-V2-API/search_creator_api_v1_douyin_xingtu_v2_search_creator_get) [REST inspection](https://api.agentik.cc/v1/tools/tikhub/douyin-xingtu-v2-search-creator) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/tikhub/douyin-xingtu-v2-search-creator) · [Agent index](/llms.txt)