Xingtu Search Toutiao Creator

2.07 credits/call
ae_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.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
tagstring | nullNo达人类型ID,多个用逗号分隔,如`1,6`/Creator category IDs, comma-separated—
pageintegerNo页码/Page number1
genderinteger | nullNo达人性别,1=男,2=女/Creator gender, 1=male, 2=female—
cpe_maxnumber | nullNo预期CPE上限/Maximum expected CPE—
cpe_minnumber | nullNo预期CPE下限/Minimum expected CPE—
cpm_maxnumber | nullNo预期CPM上限/Maximum expected CPM—
cpm_minnumber | nullNo预期CPM下限/Minimum expected CPM—
keywordstringYes搜索关键词,可为创作者昵称、头条号或内容词/Search keyword: nickname, Toutiao ID or content word—
fans_maxinteger | nullNo粉丝数上限/Maximum followers—
fans_mininteger | nullNo粉丝数下限/Minimum followers—
price_maxinteger | nullNo图文报价上限,提供时必须同时提供price_type/Maximum image-text price—
price_mininteger | nullNo图文报价下限,提供时必须同时提供price_type/Minimum image-text price—
sort_typeintegerNo排序方式,1=升序,2=降序/Sort type, 1=asc, 2=desc2
price_typeunknown | nullNo头条图文报价类型,固定为11;仅与price_min/price_max配合使用/Toutiao image-text price type, fixed to 11—
sort_fieldstringNo排序字段,默认score综合排序/Sort field, default score (comprehensive)score
extra_filterstring | nullNo额外画像筛选的JSON数组字符串,每项必须包含非空字符串field_name和field_value;支持内容主题、观众/粉丝画像、八大人群和地域等维度/Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings—
persona_tagsstring | nullNo达人人设/学历/认证/调性ID。逗号分隔=满足任一;分号分组=每组都要满足,如`1129,110401;110213`/Persona IDs. Comma=match any, semicolon=group AND—
task_categoryintegerNo合作对象/Cooperation target11
author_list_idstring | nullNo主题推荐达人清单ID/Featured creator list ID—
marketing_targetintegerNo营销目标/Marketing target1
expected_play_maxinteger | nullNo预期播放量上限/Maximum expected plays—
expected_play_mininteger | nullNo预期播放量下限/Minimum expected plays—
first_industry_idinteger | nullNo适配行业ID/Industry ID—
interact_rate_maxnumber | nullNo互动率上限,0-1小数/Maximum interaction rate, 0-1 decimal—
interact_rate_minnumber | nullNo互动率下限,0-1小数,0.02=2%/Minimum interaction rate, 0-1 decimal—
play_over_rate_maxnumber | nullNo完播率上限,0-1小数/Maximum play-completion rate, 0-1 decimal—
play_over_rate_minnumber | nullNo完播率下限,0-1小数/Minimum play-completion rate, 0-1 decimal—
burst_text_rate_maxnumber | nullNo爆文率上限,0-1小数/Maximum viral-post rate, 0-1 decimal—
burst_text_rate_minnumber | nullNo爆文率下限,0-1小数/Minimum viral-post rate, 0-1 decimal—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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": "男科吴智勇"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.