Xingtu Search Toutiao Creator
## Purpose Search Toutiao image-text creators by nickname, Toutiao account ID, or content keyword to identify potential collaboration partners. ## Inputs - **Required:** `keyword`, the search term. - **Pagination and sorting:** `page` defaults to `1`; `sort_field` defaults to `score` (overall ranking); `sort_type` is `1` for ascending or `2` for descending (default). - **Collaboration criteria:** `task_category` (cooperation target, default `11`), `marketing_target` (marketing objective, default `1`), `first_industry_id` (industry ID), and `author_list_id` (featured creator list ID). - **Creator attributes:** `tag` accepts comma-separated category IDs. `persona_tags` accepts persona, education, certification, or style IDs: commas mean match any ID; semicolons separate groups that must all match, for example `1129,110401;110213`. `gender` is `1` for male or `2` for female. `fans_min` and `fans_max` set follower bounds. - **Quotes:** `price_min` and `price_max` are nonnegative integer bounds for image-text quotes. If either is supplied, also supply `price_type=11`; this price type is used only with quote bounds. - **Performance filters:** `expected_play_min`/`expected_play_max` filter expected readership for this image-text search; `cpm_min`/`cpm_max` and `cpe_min`/`cpe_max` filter expected CPM and CPE. `interact_rate_min`/`interact_rate_max`, `play_over_rate_min`/`play_over_rate_max`, and `burst_text_rate_min`/`burst_text_rate_max` filter interaction, completion, and viral-post rates. Rate values are decimals from `0` to `1`, for example `0.02` means 2%. - **Advanced profiles:** `extra_filter` is a string containing a JSON array for supported content themes, audience/fan profiles, regions, and related dimensions. Each element must contain non-empty strings `field_name` and `field_value`; `rel_id` is optional. Encoded array values must also be represented as strings. Use valid IDs and profile field codes rather than arbitrary labels. Example inputs: ```json { "keyword": "数码", "page": 1, "gender": 2, "fans_min": 10000, "extra_filter": "[{\"field_name\":\"watcher_gender_female_rate_v2__ge\",\"field_value\":\"0.6\"}]" } ``` ## Results Returns a direct search response. Its `data` contains the creator search results and may include creator details, quotes, follower counts, and expected readership. The data payload has no fixed documented item structure, so individual fields may vary. Quotes and expected performance metrics are reference information, not guarantees of campaign outcomes.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
tag | string | null | No | 达人类型ID,多个用逗号分隔,如`1,6`/Creator category IDs, comma-separated | — |
page | integer | No | 页码/Page number | 1 |
gender | integer | null | No | 达人性别,1=男,2=女/Creator gender, 1=male, 2=female | — |
cpe_max | number | null | No | 预期CPE上限/Maximum expected CPE | — |
cpe_min | number | null | No | 预期CPE下限/Minimum expected CPE | — |
cpm_max | number | null | No | 预期CPM上限/Maximum expected CPM | — |
cpm_min | number | null | No | 预期CPM下限/Minimum expected CPM | — |
keyword | string | Yes | 搜索关键词,可为创作者昵称、头条号或内容词/Search keyword: nickname, Toutiao ID or content word | — |
fans_max | integer | null | No | 粉丝数上限/Maximum followers | — |
fans_min | integer | null | No | 粉丝数下限/Minimum followers | — |
price_max | integer | null | No | 图文报价上限,提供时必须同时提供price_type/Maximum image-text price | — |
price_min | integer | null | No | 图文报价下限,提供时必须同时提供price_type/Minimum image-text price | — |
sort_type | integer | No | 排序方式,1=升序,2=降序/Sort type, 1=asc, 2=desc | 2 |
price_type | unknown | null | No | 头条图文报价类型,固定为11;仅与price_min/price_max配合使用/Toutiao image-text price type, fixed to 11 | — |
sort_field | string | No | 排序字段,默认score综合排序/Sort field, default score (comprehensive) | score |
extra_filter | string | null | No | 额外画像筛选的JSON数组字符串,每项必须包含非空字符串field_name和field_value;支持内容主题、观众/粉丝画像、八大人群和地域等维度/Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings | — |
persona_tags | string | null | No | 达人人设/学历/认证/调性ID。逗号分隔=满足任一;分号分组=每组都要满足,如`1129,110401;110213`/Persona IDs. Comma=match any, semicolon=group AND | — |
task_category | integer | No | 合作对象/Cooperation target | 11 |
author_list_id | string | null | No | 主题推荐达人清单ID/Featured creator list ID | — |
marketing_target | integer | No | 营销目标/Marketing target | 1 |
expected_play_max | integer | null | No | 预期播放量上限/Maximum expected plays | — |
expected_play_min | integer | null | No | 预期播放量下限/Minimum expected plays | — |
first_industry_id | integer | null | No | 适配行业ID/Industry ID | — |
interact_rate_max | number | null | No | 互动率上限,0-1小数/Maximum interaction rate, 0-1 decimal | — |
interact_rate_min | number | null | No | 互动率下限,0-1小数,0.02=2%/Minimum interaction rate, 0-1 decimal | — |
play_over_rate_max | number | null | No | 完播率上限,0-1小数/Maximum play-completion rate, 0-1 decimal | — |
play_over_rate_min | number | null | No | 完播率下限,0-1小数/Minimum play-completion rate, 0-1 decimal | — |
burst_text_rate_max | number | null | No | 爆文率上限,0-1小数/Maximum viral-post rate, 0-1 decimal | — |
burst_text_rate_min | number | null | No | 爆文率下限,0-1小数/Minimum viral-post rate, 0-1 decimal | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_xingtu_search_toutiao_creator' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keyword": "男科吴智勇"
}
}'{
"code": 200,
"data": {
"authors": [
{
"attribute_datas": {
"article_expected_vv": "0",
"article_interate_rate": "0",
"auth_type": "0",
"author_avatar_frame_icon": "0",
"author_status": "0",
"author_type": "1"
},
"extra_data": {
"assign_live_restrict_tip": "当前账号暂无法向该达人发起任务",
"assign_live_restricted": true,
"content_query_score": 0,
"recall_from": [
"1_0"
]
},
"star_id": "6811497074652086279",
"task_infos": [
{
"online_status": 1,
"platform_source": 2,
"task_category": 11,
"task_status": 1
}
]
}
],
"base_resp": {
"status_code": 0
},
"extra_data": {
"intent_score": 0.013114494271576405,
"is_cpm_project_search": false,
"is_intent_consistent": false,
"search_author_count": 0,
"search_item_count": 0,
"search_session_id": "7708961611952406571"
},
"pagination": {
"has_more": false,
"limit": 20,
"page": 1,
"total_count": 12
}
},
"docs": "https://api.tikhub.io/#/Douyin-Xingtu-V2-API/search_toutiao_creator_api_v1_douyin_xingtu_v2_search_toutiao_creator_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "7e2560f3-fc06-4897-a7bf-388a5f21331e"
}This example shows part of the response. Copied content is valid JSON.






