Search creator accounts

GET/v1/user/search1 Credit / user (min 10 Credits)($0.10 / 1K users)

Discover TikTok creators by keyword with optional filters for follower tier and verification status. Paginated via cursor and has_more.

Query Parameters

keywordsstringrequired
Search keywords or username query.
Example: ai
cursorinteger
Pagination cursor (0 for first page, then pass data.cursor).
Example: 0
follower_countinteger
Follower count tier: 0 = Any, 1 = 0–1K, 2 = 1K–10K, 3 = 10K–100K, 4 = 100K+.
Example: 0
profile_typeinteger
Verification filter: 0 = Any, 1 = Verified accounts only.
Example: 0
search_emphasisinteger
Search scope: 0 = General, 1 = Username match only.
Example: 0

curl "https://api.tiktokapi.io/v1/user/search?keywords=ai" \
  -H "x-api-key: tk_your_api_key"

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.15,
  "data": {}
}

Success (code === 0). Charged according to the endpoint credit rate.

200: Success (code === 0). Charged according to the endpoint credit rate.
400: Invalid parameters, or API key placed in the URL query string (not charged).
401: Missing or invalid x-api-key header (not charged).
402: Insufficient credit balance (not charged).
403: Account disabled (not charged).
404: Unknown endpoint or disabled unstable endpoint (not charged).
405: Method not allowed — all /v1/* data endpoints use GET (not charged).
429: Rate limit exceeded (not charged). Respect the Retry-After header.
503: Temporary upstream or gateway error (not charged). Retry with exponential backoff.