API reference · Douyin

douyin/xingtu-v2/search-toutiao-creator

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

APISynchronousOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDdouyin/xingtu-v2/search-toutiao-creator

Input Schema

29 parameters · 1 required · 28 optional

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

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Code Examples

Ready-to-run snippets

const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/run", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "douyin/xingtu-v2/search-toutiao-creator",
    "page": 1,
    "sort_type": 2,
    "sort_field": "score",
    "task_category": 11,
    "marketing_target": 1
  }),
});

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

← Back to Search Toutiao Creator