SocialPipe docs

Douyin Xingtu V2 Search Creator

GET/v1/douyin/xingtu_v2/search_creator

Returns personal data about people in bulk. The response carries accounts who are not the subject of your request. See our terms for what you may do with it.

Costs 1 credit. A cache hit costs nothing, and an answer that contains no data is never charged.

curl "https://api.socialpipe.dev/v1/douyin/xingtu_v2/search_creator" \  -H "Authorization: Bearer $SOCIALPIPE_KEY"
AuthorizationBearer <token>

Your SocialPipe API key, as Authorization: Bearer sp_live_…. Create one in the dashboard.

In: header

Query Parameters

keyword?|

seach_type=2=3/Optional keyword; empty means filter-only browsing

seach_type?|

2=3=/Search mode: 2=nickname, 3=content

time_range_days?|

30/90/180seach_type=3/Content time range; only for seach_type=3

page?|

Page number

sort_field?|

score/Sort field, default score (comprehensive)

sort_type?|

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

task_category?|

Cooperation target

marketing_target?|

Marketing target

first_industry_id?|

ID0=/Industry ID, 0=unlimited

author_list_id?|

ID/Featured creator list ID

price_type?|

1=1-202=21-603=60price_min/price_max/Creator video price tier

price_min?|

price_type/Minimum creator price

price_max?|

price_type/Maximum creator price

tag?|

ID1,6/Creator category IDs, comma-separated

persona_tags?|

ID==1129,110401;110213/Persona IDs. Comma=match any, semicolon=group AND

gender?|

1=2=/Creator gender, 1=male, 2=female

fans_min?|

Minimum followers

fans_max?|

Maximum followers

expected_play_min?|

Minimum expected plays

expected_play_max?|

Maximum expected plays

cpm_min?|

CPM/Minimum expected CPM

cpm_max?|

CPM/Maximum expected CPM

cpe_min?|

CPE/Minimum expected CPE

cpe_max?|

CPE/Maximum expected CPE

interact_rate_min?|

0-10.02=2%/Minimum interaction rate, 0-1 decimal

interact_rate_max?|

0-1/Maximum interaction rate, 0-1 decimal

play_over_rate_min?|

0-1/Minimum play-completion rate, 0-1 decimal

play_over_rate_max?|

0-1/Maximum play-completion rate, 0-1 decimal

burst_text_rate_min?|

0-1/Minimum viral-post rate, 0-1 decimal

burst_text_rate_max?|

0-1/Maximum viral-post rate, 0-1 decimal

extra_filter?|

JSONfield_namefield_value//Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings

cache_ttl?|

Max acceptable age of a cached result, in seconds. A lower value demands fresher data; it does not shorten what is stored.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/douyin/xingtu_v2/search_creator"
{  "cache_age": 0,  "cached": false,  "credits_remaining": 0,  "credits_used": 0,  "data": {},  "schema_version": "2",  "success": true,  "took_ms": 0}