Skip to main content
GET
douyin search_creator
Search Creator Pricing — billed per successful call; the final charge scales by your plan multiplier. Charged only when the upstream response body code is 200.

Example

Cost and request rules

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.001
  • Cost contract: fixed_success
  • Published reference multiplier: 1.0
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

author_list_id
string | null

Featured creator list ID

burst_text_rate_max
number | null

Maximum viral-post rate as a decimal between 0 and 1.

Required range: 0 <= x <= 1
burst_text_rate_min
number | null

Minimum viral-post rate as a decimal between 0 and 1.

Required range: 0 <= x <= 1
cpe_max
number | null

Maximum expected CPE

cpe_min
number | null

Minimum expected CPE

cpm_max
number | null

Maximum expected CPM

cpm_min
number | null

Minimum expected CPM

expected_play_max
integer | null

Maximum expected plays

expected_play_min
integer | null

Minimum expected plays

extra_filter
string | null

Extra profile filters encoded as a JSON-array string. Each item must include non-empty string field_name and field_value; related-tier filters may also include rel_id. Supports content themes, viewer/follower profiles, audience groups, locations, and dynamic filter options.

fans_max
integer | null

Maximum follower count, for example 200000 for at most 200,000 followers.

fans_min
integer | null

Minimum follower count, for example 100000 for at least 100,000 followers.

first_industry_id
integer
default:0

Industry ID, 0=unlimited

Usage: First-level industry ID; 0 means unrestricted.

gender
integer | null

Creator gender, 1=male, 2=female

interact_rate_max
number | null

Maximum interaction rate as a decimal between 0 and 1.

Required range: 0 <= x <= 1
interact_rate_min
number | null

Minimum interaction rate as a decimal between 0 and 1; 0.02 means 2%.

Required range: 0 <= x <= 1
keyword
string
default:""

Optional keyword; empty means filter-only browsing. seach_type=2 matches nickname, =3 matches content

marketing_target
integer
default:1

Marketing target

page
integer
default:1

Page number starting from 1.

persona_tags
string | null

Persona IDs (persona/education/certification/tone). Comma=match any; semicolon=group AND, e.g. 1129,110401;110213

play_over_rate_max
number | null

Maximum play-completion rate as a decimal between 0 and 1.

Required range: 0 <= x <= 1
play_over_rate_min
number | null

Minimum play-completion rate as a decimal between 0 and 1.

Required range: 0 <= x <= 1
price_max
integer | null

Maximum creator price. Supply price_type whenever this field is set.

Required range: x >= 0
price_min
integer | null

Minimum creator price. Supply price_type whenever this field is set.

Required range: x >= 0
price_type
enum<integer>

Creator video price tier: 1=1-20 seconds, 2=21-60 seconds, 3=60 seconds or above; used only in combination with price_min/price_max

Available options:
1,
2,
3
seach_type
enum<integer>
default:2

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

Usage: 2=nickname (default), 3=content.

Available options:
2,
3
sort_field
string
default:score

Sort field, default score (comprehensive)

sort_type
integer
default:2

Sort type: 1=asc, 2=desc

Usage: 1=ascending, 2=descending.

tag
string | null

Creator category IDs, comma-separated, e.g. 1,6

task_category
integer
default:1

Cooperation target

time_range_days
enum<integer>
default:180

Content time range; only effective when seach_type=3

Usage: Content range of 30, 90, or 180 days; only applies to content search.

Available options:
30,
90,
180

Response

Successful Response

Return

  • Creator results, pagination information, and related metrics.
code
integer
default:200

HTTP status code

request_id
string | null

Unique request identifier

message
string
default:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh
string
default:请求成功,本次请求将被计费。

Response message (ZH-CN)

support
string
default:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time
string

The time the response was generated

time_stamp
integer

The timestamp the response was generated

time_zone
string
default:America/Los_Angeles

The timezone of the response time

docs
string | null

Link to the API Swagger documentation for this endpoint

cache_message
string | null
default:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh
string | null
default:本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

router
string
default:""

The endpoint that generated this response

params
any
default:{}

The parameters used in the request

data
any

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.