douyin/xingtu-v2/search-creator
Search Douyin short-video creators in the creator marketplace by keyword, with full filtering.
Input
Maximum viral-post rate, 0-1 decimal
Minimum viral-post rate, 0-1 decimal
Maximum expected CPE
Minimum expected CPE
Maximum expected CPM
Minimum expected CPM
Maximum expected plays
Minimum expected plays
Extra profile filters (JSON array) for audience/fans profile, region, etc.
Maximum followers
Minimum followers
Industry ID, 0=unlimited
Creator gender, 1=male, 2=female
Maximum interaction rate, 0-1 decimal
Minimum interaction rate, 0-1 decimal
Search keyword: nickname, Douyin ID, Xingtu ID or content word
Marketing target
Page number, default 1
Maximum play-completion rate, 0-1 decimal
Minimum play-completion rate, 0-1 decimal
Maximum creator price
Minimum creator price
Price tier by video length
Sort field, default `score` (comprehensive sort)
Sort type, 1=asc, 2=desc, default 2
Creator category IDs, comma-separated
Cooperation target
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
douyin/xingtu-v2/search-creator01
Input Schema
29 parameters · 1 required · 28 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword | string | Required | Search keyword: nickname, Douyin ID, Xingtu 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: 1 |
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 | integer | Optional | Industry ID, 0=unlimited · Default: 0 |
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 |
02
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 |
03
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "douyin/xingtu-v2/search-creator",
"page": 1,
"sort_type": 2,
"sort_field": "score",
"task_category": 1,
"marketing_target": 1,
"first_industry_id": 0,
"prompt": "a beautiful sunset over mountains"
}'API README
Search Creator
Search Douyin short-video creators in the creator marketplace by keyword, with full filtering. It is suitable for douyin workflows.
Capability
Search Douyin short-video creators in the creator marketplace by keyword, with full filtering. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Search and discover relevant records for research, monitoring, and product experiences.
- Build media monitoring, content intelligence, and publishing-support workflows.
- Power market dashboards, alerts, comparisons, and scheduled data collection.