# Douyin Xingtu Toutiao creator search Search Toutiao image-text creators in the image-text marketplace by keyword, with full filtering. Needs keyword. Served by TikHub. Purpose: - Search Toutiao image-text creators in the image-text marketplace by keyword, with full filtering 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 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.) - Tool ID: `tikhub/douyin-xingtu-v2-search-toutiao-creator` - Name in the catalog: Douyin, Search Toutiao Creator - Provider: [TikHub](/providers/tikhub.md) - Capability: [Xingtu creator marketplace](/tools/douyin/xingtu.md) - Price: $0.001 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.001 } ``` 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.001; 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": "搜索关键词，可为创作者昵称、头条号或内容词/Search keyword: nickname, Toutiao ID or content word", "title": "Keyword" }, "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": 11, "title": "Task Category" }, "marketing_target": { "type": "integer", "description": "营销目标/Marketing target", "default": 1, "title": "Marketing Target" }, "first_industry_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "适配行业ID/Industry ID", "title": "First Industry Id" }, "author_list_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "主题推荐达人清单ID/Featured creator list ID", "title": "Author List Id" }, "price_type": { "anyOf": [ { "type": "integer", "enum": [ 11 ], "title": "XingtuToutiaoPriceType" }, { "type": "null" } ], "description": "头条图文报价类型，固定为11；仅与price_min/price_max配合使用/Toutiao image-text price type, fixed to 11", "title": "Price Type" }, "price_min": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "description": "图文报价下限，提供时必须同时提供price_type/Minimum image-text price", "title": "Price Min" }, "price_max": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "description": "图文报价上限，提供时必须同时提供price_type/Maximum image-text 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" } }, "required": [ "keyword" ], "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-toutiao-creator", "input": { "keyword": "数码", "page": 1, "sort_field": "score", "sort_type": 2, "task_category": 11, "marketing_target": 1, "price_type": 11, "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_toutiao_creator_api_v1_douyin_xingtu_v2_search_toutiao_creator_get) [REST inspection](https://api.agentik.cc/v1/tools/tikhub/douyin-xingtu-v2-search-toutiao-creator) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/tikhub/douyin-xingtu-v2-search-toutiao-creator) · [Agent index](/llms.txt)