Skip to main content
GET
Douyin Search Users
This reference describes a preview operation. Test the required call before integrating it; a request that is unavailable returns HTTP 503 without consuming credits.

Authorizations

x-api-key
string
header
required

Headers

Cache-Control
string
Idempotency-Key
string
X-Max-Credits
integer

Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero.

Required range: x >= 0

Query Parameters

query
string
required
limit
integer
Required range: 1 <= x <= 25
cursor
string
followers
enum<string>
Available options:
all,
under_1k,
1k_to_10k,
10k_to_100k,
100k_to_1m,
over_1m
user_type
enum<string>
Available options:
all,
regular_user,
enterprise_verified,
individual_verified

Response

Request completed. Interpret data using the selected resource contract.

success
boolean
required
platform
string
required
endpoint
string
required
credits_used
integer
required
Required range: x >= 0
credits_remaining
integer | null
required
request_id
string
required
cached
boolean
required
data
object
required

The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.