douyin

Search › Users

Returns Douyin creators matching a keyword: nickname, Douyin ID, bio, follower count, total likes received, avatar, profile URL, and verification label.

Use it to shortlist creators by keyword, follower band, or account type; use search to find videos instead.

Metered: 50–1250 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Paginates by cursor: see Pagination.

get/v1/douyin/search/users

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/douyin/search/users
  • Auth: API key in header x-api-key

Query parameters

querystring required
Example:美食

Search keywords, for example 美食 or a brand name.

limitinteger

Rows to return, 1 to 25. Default 10.

cursorstring

Continuation token from a previous response's pagination block. Omit for the first page.

followers'all' | 'under_1k' | '1k_to_10k' | '10k_to_100k' | '100k_to_1m' | 'over_1m'

Follower band: all, under_1k, 1k_to_10k, 10k_to_100k, 100k_to_1m, or over_1m. Default all.

user_type'all' | 'regular_user' | 'enterprise_verified' | 'individual_verified'

Account type: all, regular_user, enterprise_verified, or individual_verified. Default all.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.