Douyin Toutiao Creator Search

Name: Douyin Toutiao Creator Search
Price: 0.0015 USD
Availability: InStock
Author: Douyin

https://api.sandbase.ai/v1/api/douyin/xingtu-v2/search-toutiao-creator

Returns Toutiao image-text creator profiles matching a search keyword and filters such as follower count, interaction rate, and industry categories.

Try this API Get API key

Price: $0.0015USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 1 required · 28 optional

Production route

Try the model

Playground

Open playground

Input

Author List Id

Featured creator list ID

Burst Text Rate Max

Maximum viral-post rate, 0-1 decimal

Burst Text Rate Min

Minimum viral-post rate, 0-1 decimal

Cpe Max

Maximum expected CPE

Cpe Min

Minimum expected CPE

Cpm Max

Maximum expected CPM

Cpm Min

Minimum expected CPM

Expected Play Max

Maximum expected plays

Expected Play Min

Minimum expected plays

Extra Filter

Extra profile filters (JSON array) for audience/fans profile, region, etc.

Fans Max

Maximum followers

Fans Min

Minimum followers

First Industry Id

Industry ID

Gender

Creator gender, 1=male, 2=female

Interact Rate Max

Maximum interaction rate, 0-1 decimal

Interact Rate Min

Minimum interaction rate, 0-1 decimal

Keyword(string)

Search keyword: nickname, Toutiao ID or content word

Marketing Target(integer)

Marketing target

Page(integer)

Page number, default 1

Persona Tags

Persona IDs. Comma=match any, semicolon=group AND

Play Over Rate Max

Maximum play-completion rate, 0-1 decimal

Play Over Rate Min

Minimum play-completion rate, 0-1 decimal

Price Max

Maximum creator price

Price Min

Minimum creator price

Price Type

Price tier by video length

Sort Field(string)

Sort field, default `score` (comprehensive sort)

Sort Type(integer)

Sort type, 1=asc, 2=desc, default 2

Tag

Creator category IDs, comma-separated

Task Category(integer)

Cooperation target

OutputExample

Responseoutputs · 13.6 KB · 421 lines

[
  {
    "data": {
      "authors": [
        {
          "attribute_datas": {
            "article_expected_vv": "17642",
            "article_interate_rate": "0.0409",
            "auth_info": "微头条首发创作者",
            "auth_type": "0",
            "author_avatar_frame_icon": "0",
            "author_status": "0",
            "author_type": "1",
            "avatar_uri": "https://sf3-cdn-tos.toutiaostatic.com/img/user-avatar/135a0f72919777e6f0dffc0c8cf3dc5e~300x300.image",
            "city": "\"青岛\"",
            "core_user_id": "4042405212",
            "e_commerce_enable": "1",
            "follower": "358128",
            "gender": "1",
            "id": "6729826071128047630",
            "nick_name": "人工智能研究所",
            "province": "\"山东\"",
            "tags_relation": "{\"科技\":[\"科技\"]}",
            "toutiao_category": "科技",
            "toutiao_expected_cpm": "1867.7624",
            "toutiao_expected_imp_cnt": "2677",
            "toutiao_interact_rate": "0.1898",
            "weitoutiao_expected_cpm": "189.3427",
            "weitoutiao_expected_imp_cnt": "3697",
            "weitoutiao_interact_rate": "0.0067",
            "wetoutiao_expected_vv": "3505",
            "wetoutiao_interate_rate": "0.009"
          },
          "extra_data": {
            "content_query_from_word": "",
            "content_query_score": 0,
            "debug_info": "",
            "recall_from": [
              "1_0"
            ],
            "recall_return_infos": {},
            "recommend_types": []
          },
          "items": [],
          "star_id": "6729826071128047630",
          "task_infos": [
            {
              "online_status": 1,
              "platform_source": 2,
              "price_infos": [
                {
                  "end_time": "2145916800",
                  "platform_source": 2,
                  "price": 5000,
                  "price_extra_info": {},
                  "start_time": "1732982400",
                  "task_category": 11,
                  "video_type": 11,
                  "video_type_status": 1
                }
              ],
              "task_category": 11,
              "task_status": 1
            }
          ]
        },
        {
          "attribute_datas": {
            "article_expected_vv": "12881",
            "article_interate_rate": "0.093",
            "auth_info": "",
            "auth_type": "0",
            "author_avatar_frame_icon": "0",
            "author_status": "0",
            "author_type": "2",
            "avatar_uri": "https://sf1-cdn-tos.toutiaostatic.com/img/user-avatar/c8a386ff26b08bdfce3ce626fb9987a7~300x300.image",
            "city": "\"杭州\"",
            "core_user_id": "51463884458",
            "e_commerce_enable": "1",
            "follower": "155668",
            "gender": "3",
            "id": "6761338393973489672",
            "nick_name": "人工智能技术分享AI",
            "province": "\"浙江\"",
            "tags_relation": "{\"科技\":[\"科技\"]}",
            "toutiao_category": "科技",
            "toutiao_expected_cpm": "1367.7812",
            "toutiao_expected_imp_cnt": "1316",
            "toutiao_interact_rate": "0.2254",
            "weitoutiao_expected_cpm": "430.622",
            "weitoutiao_expected_imp_cnt": "2090",
            "weitoutiao_interact_rate": "0.0058",
            "wetoutiao_expected_vv": "1159",
            "wetoutiao_interate_rate": "0.096"
          },
          "extra_data": {
            "content_query_from_word": "",
            "content_query_score": 0,
            "debug_info": "",
            "recall_from": [
              "1_0"
            ],
            "recall_return_infos": {},
            "recommend_types": []
          },
          "items": [],
          "star_id": "6761338393973489672",
          "task_infos": [
            {
              "online_status": 1,
              "platform_source": 2,
              "price_infos": [
                {
                  "end_time": "2145916800",
                  "platform_source": 2,
                  "price": 1800,
                  "price_extra_info": {},
                  "start_time": "1604160000",
                  "task_category": 11,
                  "video_type": 11,
                  "video_type_status": 1
                }
              ],
              "task_category": 11,
              "task_status": 1
            }
          ]
        },
        {
          "attribute_datas": {
            "article_expected_vv": "0",
            "article_interate_rate": "0",
            "auth_info": "优质科技领域创作者",
            "auth_type": "0",
            "author_avatar_frame_icon": "0",
            "author_status": "0",
            "author_type": "1",
            "avatar_uri": "https://sf6-cdn-tos.toutiaostatic.com/img/user-avatar/2x_8f2ffe9512e926df6c43aa06587f7613~300x300.image",
            "city": "\"北京\"",
            "core_user_id": "96455262628",
            "e_commerce_enable": "1",
            "follower": "41144",
            "gender": "1",
            "id": "6794484829627875335",
            "nick_name": "人工智能遇见磐创",
            "province": "\"北京\"",
            "tags_relation": "{\"科技\":[\"科技\"]}",
            "toutiao_category": "科技",
            "wetoutiao_expected_vv": "0",
            "wetoutiao_interate_rate": "0"
          },
          "extra_data": {
            "content_query_from_word": "",
            "content_query_score": 0,
            "debug_info": "",
            "recall_from": [
              "1_0"
            ],
            "recall_return_infos": {},
            "recommend_types": []
          },
          "items": [],
          "star_id": "6794484829627875335",
          "task_infos": [
            {
              "online_status": 1,
              "platform_source": 2,
              "price_infos": [
                {
                  "end_time": "2145916800",
                  "platform_source": 2,
                  "price": 1200,
                  "price_extra_info": {},
                  "start_time": "1581964531",
                  "task_category": 11,
                  "video_type": 11,
                  "video_type_status": 1
                }
              ],
              "task_category": 11,
              "task_status": 1
            }
          ]
        },
        {
          "attribute_datas": {
            "article_expected_vv": "0",
            "article_interate_rate": "0",
            "auth_info": "",
            "auth_type": "3",
            "author_avatar_frame_icon": "0",
            "author_status": "0",
            "author_type": "1",
            "avatar_uri": "https://sf6-cdn-tos.toutiaostatic.com/img/user-avatar/2x_c8887fabf50de1f4cffa87b0789ea1ce~300x300.image",
            "city": "\"北京\"",
            "core_user_id": "3869412005",
            "e_commerce_enable": "0",
            "follower": "1115",
            "gender": "1",
            "id": "6753513114592870414",
            "nick_name": "人工智能学徒",
            "province": "\"北京\"",
            "tags_relation": "{}",
            "wetoutiao_expected_vv": "0",
            "wetoutiao_interate_rate": "0"
          },
          "extra_data": {
            "content_query_from_word": "",
            "content_query_score": 0,
            "debug_info": "",
            "recall_from": [
              "1_0"
            ],
            "recall_return_infos": {},
            "recommend_types": []
          },
          "items": [],
          "star_id": "6753513114592870414",
          "task_infos": [
            {
              "online_status": 2,
              "platform_source": 2,
              "price_infos": [
                {
                  "end_time": "2145916800",
                  "platform_source": 2,
                  "price": 1,
                  "price_extra_info": {},
                  "start_time": "1578229477",
                  "task_category": 11,
                  "video_type": 11,
                  "video_type_status": 1
                }
              ],
              "task_category": 11,
              "task_status": 1
            }
          ]
        },
        {
          "attribute_datas": {
            "auth_info": "",
            "auth_type": "3",
            "author_avatar_frame_icon": "0",
            "author_status": "0",
            "author_type": "1",
            "avatar_uri": "https://sf1-cdn-tos.toutiaostatic.com/img/user-avatar/0430a1ee36cdcf7c8d06c227f5c58928~300x300.image",
            "city": "\"萍乡\"",
            "core_user_id": "5368566837",
            "e_commerce_enable": "0",
            "follower": "191",
            "gender": "1",
            "id": "6933445501106782215",
            "nick_name": "卓曼科技（人工智能）",
            "province": "\"江西\"",
            "tags_relation": "{\"发文离散\":[\"发文离散\"]}",
            "toutiao_category": "发文离散"
          },
          "extra_data": {
            "content_query_from_word": "",
            "content_query_score": 0,
            "debug_info": "",
            "recall_from": [
              "1_0"
            ],
            "recall_return_infos": {},
            "recommend_types": []
          },
          "items": [],
          "star_id": "6933445501106782215",
          "task_infos": []
        },
        {
          "attribute_datas": {
            "auth_info": "",
            "auth_type": "0",
            "author_avatar_frame_icon": "0",
            "author_status": "1",
            "author_type": "1",
            "avatar_uri": "https://sf1-cdn-tos.toutiaostatic.com/img/user-avatar/ed76a80be6a29f7bb97c5a44451a04dc~300x300.image",
            "city": "",
            "core_user_id": "92360114872",
            "follower": "39",
            "gender": "1",
            "id": "7521157054032707622",
            "nick_name": "人工智能天天短剧",
            "province": "",
            "tags_relation": "{\"发文离散\":[\"发文离散\"]}",
            "toutiao_category": "发文离散"
          },
          "extra_data": {
            "content_query_from_word": "",
            "content_query_score": 0,
            "debug_info": "",
            "recall_from": [
              "1_0"
            ],
            "recall_return_infos": {},
            "recommend_types": []
          },

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price: $0.0015 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

keyword: string · required
author_list_id: any · optional
burst_text_rate_max: any · optional
burst_text_rate_min: any · optional
cpe_max: any · optional
cpe_min: any · optional
cpm_max: any · optional
cpm_min: any · optional
expected_play_max: any · optional
expected_play_min: any · optional
extra_filter: any · optional
fans_max: any · optional
More: +17 optional parameters

Access

Provider: Douyin
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/douyin/xingtu-v2/search-toutiao-creator
Authentication: Bearer API key

API README

Douyin Toutiao Creator Search API

Query Toutiao creators across the Xingtu marketplace using a search keyword along with optional filters for metrics, tags, and audience profiles.

Use cases

Find Toutiao creators by nickname, Toutiao ID, or content topic.
Filter creators by follower counts, play completion rates, and expected performance metrics.
Sort creator search results by platform score or custom ranking fields.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu-v2/search-toutiao-creator" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "人工智能"}'

Parameters

Name	Type	Required	Description
`keyword`	string	Yes	Search keyword: nickname, Toutiao ID or content word
`tag`	string	No	Creator category IDs, comma-separated
`page`	integer	No	Page number, default 1
`gender`	string	No	Creator gender, 1=male, 2=female
`cpe_max`	string	No	Maximum expected CPE
`cpe_min`	string	No	Minimum expected CPE
`cpm_max`	string	No	Maximum expected CPM
`cpm_min`	string	No	Minimum expected CPM
`fans_max`	string	No	Maximum followers
`fans_min`	string	No	Minimum followers
`price_max`	string	No	Maximum creator price
`price_min`	string	No	Minimum creator price
`sort_type`	integer	No	Sort type, 1=asc, 2=desc, default 2
`price_type`	string	No	Price tier by video length
`sort_field`	string	No	Sort field, default `score` (comprehensive sort)
`extra_filter`	string	No	Extra profile filters (JSON array) for audience/fans profile, region, etc.
`persona_tags`	string	No	Persona IDs.
`task_category`	integer	No	Cooperation target
`author_list_id`	string	No	Featured creator list ID
`marketing_target`	integer	No	Marketing target
`expected_play_max`	string	No	Maximum expected plays
`expected_play_min`	string	No	Minimum expected plays
`first_industry_id`	string	No	Industry ID
`interact_rate_max`	string	No	Maximum interaction rate, 0-1 decimal
`interact_rate_min`	string	No	Minimum interaction rate, 0-1 decimal
`play_over_rate_max`	string	No	Maximum play-completion rate, 0-1 decimal
`play_over_rate_min`	string	No	Minimum play-completion rate, 0-1 decimal
`burst_text_rate_max`	string	No	Maximum viral-post rate, 0-1 decimal
`burst_text_rate_min`	string	No	Minimum viral-post rate, 0-1 decimal

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "authors": [
    {
      "star_id": "6729826071128047630",
      "attribute_datas": {
        "article_interate_rate": "0.0409",
        "auth_type": "0",
        "author_status": "0",
        "author_type": "1",
        "core_user_id": "4042405212",
        "id": "6729826071128047630"
      }
    }
  ]
}

Notes

The required keyword parameter matches creator nicknames, Toutiao IDs, or content words.
Set gender to 1 for male or 2 for female.
Pagination uses page (default 1), and sort_type defaults to 2 for descending order.

Related APIs

Douyin Xingtu Author Audience Distribution: Returns audience profile distribution metrics for a specified Xingtu creator based on creator ID and link type, with selectable platform source and channel opt…
Douyin Xingtu Author Base Info: Returns basic creator profile data from Douyin Xingtu by author identifier, with options to include recommendation details and linkage information.
Douyin Xingtu Author Business Card Info: Returns business card details for a Douyin Xingtu creator based on the specified author ID.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/douyin/xingtu-v2/search-toutiao-creator

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu-v2/search-toutiao-creator" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "page": 1,
  "keyword": "人工智能",
  "sort_type": 2,
  "sort_field": "score",
  "task_category": 11,
  "marketing_target": 1
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
Douyin Toutiao Creator SearchThis API `Douyin`	$0.0015 per call	JSON	Jul 31, 2026
Douyin Xingtu Author Audience Distribution `Douyin`	$0.003 per call	JSON	Jul 31, 2026
Douyin Xingtu Author Base Info `Douyin`	$0.0015 per call	JSON	Jul 31, 2026
Douyin Xingtu Author Business Card Info `Douyin`	$0.0015 per call	JSON	Jul 31, 2026
Douyin Xingtu Author Content Hot Keywords `Douyin`	$0.0015 per call	JSON	Jul 31, 2026
Douyin Xingtu Author Conversion Ability `Douyin`	$0.003 per call	JSON	Jul 31, 2026

Questions

FAQ

How do I use the Douyin Toutiao Creator Search API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/xingtu-v2/search-toutiao-creator with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Douyin Toutiao Creator Search API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Douyin Toutiao Creator Search API accept?

Required: keyword (string). Optional: author_list_id (any), burst_text_rate_max (any), burst_text_rate_min (any), cpe_max (any), cpe_min (any) and cpm_max (any) and 22 more. The Parameters table and the Playground on this page list every field.

What does the Douyin Toutiao Creator Search API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Douyin developer account or API key?

No. Douyin Toutiao Creator Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.