TikTok User search API
Search TikTok accounts by keyword with cursor pagination: handle, nickname and follower count.
$0.60/1k req, pay per request, no subscription.
{"handle": "cristiano","nickname": "Cristiano Ronaldo","userId": "6757029651601835013","followers": 64200000,"following": 12,"avatarUrl": string,"bio": string | null,"instagramUrl": string | null,... 6 more fields}
Pricing and providers
TikTok User search API pricing: one API, 6 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get TikTok user search in one request
This sample shows 9 of 19 fields. See every field
{
"found": true,
"data": {
"nextCursor": "30",
"users": [
{
"handle": "cristiano",
"nickname": "Cristiano Ronaldo",
"userId": "6757029651601835013",
"followers": 64200000,
"following": 12
}
]
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-11-05 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- querystring
cristiano
The keyword to search TikTok accounts for.
- cursorstring
Pagination cursor from a previous response's nextCursor.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `secUid` or `bio`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a record that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Response
JSON, one example value per field.
- nextCursorstringcan require
30
Opaque cursor for the next page of users, or null when this lane has no more. Pass it back as cursor to continue.
Populated whenever the provider has data for the entity.
- avatarUrlstring
Account avatar image URL. Signed and short-lived, so the query string is load-bearing and kept intact.
- biostringcan require
Profile biography text. Null when the serving source does not report it.
- followersinteger
64200000
- followinginteger
12
- handlestring
cristiano
Populated whenever the provider has data for the entity.
- instagramUrlstringcan require
Instagram profile the account links on TikTok. Null when it links none or the serving source does not report it.
- likesinteger
Total likes the account has received.
- nicknamestring
Cristiano Ronaldo
Populated whenever the provider has data for the entity.
- regionstringcan require
Two-letter country code TikTok assigns the account. Null when the serving source does not report it.
- secUidstringcan require
TikTok's sec_uid for the account. Pass it to tiktok.profile_reposts or tiktok.profile_playlists. Null when the serving source does not report it.
- userIdstring
6757029651601835013
Populated whenever the provider has data for the entity.
- verifiedboolean
Whether the account carries a TikTok verification badge.
- videosinteger
Number of videos the account has posted.
- youtubeUrlstringcan require
YouTube channel the account links on TikTok. Null when it links none or the serving source does not report it.
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the TikTok User search API
The AnyAPI TikTok User search API returns TikTok user search data as normalized JSON from one POST call to /v1/run/tiktok.search_users. Search TikTok accounts by keyword with cursor pagination: handle, nickname and follower count. AnyAPI routes each request across 6 sources and falls back automatically when one fails. It costs from $0.60 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of TikTok user search calls through AnyAPI succeeded, with a median response time of 1.3 seconds across 78,722 measured calls.
