App Logo
tiktok.com

Search TikTok users

TL;DR

Automatically search TikTok users on tiktok.com. Type part of a name or @handle and get the 10 or so accounts TikTok matches, with followers, likes and bio.

About

TikTok's user search is where you go when you half remember a creator's name, or want to see who else is trading on your brand. You get the first batch TikTok matches, usually about 10 accounts, each with its @handle, bio, follower count, total likes and verified flag, which is normally enough to tell the real account from a fan page. A small Lyon candle shop's social lead, for example, searches the shop's name every Monday, sets its own account aside, sorts the rest by followerCount and runs get_profile on the top few to see which are private or only a few weeks old. The catch is volume. There is no next-page option, so wider coverage means more spellings, or a city or niche word added to the name. Searches need a browser signed in to TikTok. If TikTok sends back a blank response, the run reloads and retries, three attempts in all, then stops with an error.

Input

query required

Search keyword(s) — name or handle fragment.

Output

query required
total required

Number of users returned (TikTok web caps this around 10 per query; the endpoint's has_more/count/offset are non-functional for this surface, so there is no deeper page).

users required

Example output

Shape only: placeholder values generated from the output schema, not a real run.

{ "query": "…", "total": 3, "users": [ { "id": "abc123", "secUid": "…", "nickname": "…", "uniqueId": "abc123", "verified": true, "signature": "…", "heartCount": 3.5, "followerCount": 3.5 } ] }

FAQ

Search TikTok accounts by keyword. Returns the top ~10 matches (TikTok web caps user search; not deeply paginable).
Ask an AI agent connected to Reduck to run reduck/tiktok.com/search_users, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/tiktok.com/search_users
You do not need one. "Search TikTok users" drives the real tiktok.com pages in a browser, so it works whether or not tiktok.com offers an API for this.
Required: query.
It returns query, total, users.
Yes. It acts as you on tiktok.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the tiktok.com cookies saved by the Reduck extension.
Unknown: its author has not declared whether it changes anything on tiktok.com, so treat it as if it could.
Ask an AI agent connected to Reduck to run reduck/tiktok.com/search_users, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/tiktok.com/search_users
It is part of Reduck's official curated catalogue.
Reduck's TikTok user search returns only the first batch of accounts TikTok's website sends back, usually about 10, and in testing a request for the next page brought back nothing new. To reach more accounts, run variations of the name (add a city, a niche word or part of a handle) and merge the results on uniqueId. The get_search_suggestions script returns TikTok's autocomplete for a keyword without a sign-in, which makes a quick list of variations to rerun.
Search the name or part of the @handle: each result carries id, TikTok's numeric user ID, and secUid, the stable opaque ID other TikTok requests use to identify an account. If you already know the exact @handle, get_profile returns both IDs plus following count, video count, region and private status, and it works without being signed in to TikTok.
Reduck's TikTok user search takes a name or part of a handle, so for a subject like sourdough or pottery it works better to start from videos. The search_videos script returns up to 300 videos for a keyword, each with its author's uniqueId; collect those handles, drop duplicates, and pass the ones worth a closer look to get_profile or get_user_videos.
Brands can use the Explore creators section of TikTok One, which searches by username or by a keyword creators have posted about and filters by country or region, follower count, language and audience. TikTok's Research API does not fit this job: it is limited to academic and not-for-profit researchers independent of commercial interests, and its user info endpoint looks up a username you already know rather than searching by keyword.

Related scripts

tiktok.com

Get TikTok following

List who a TikTok user follows, by @username. Accounts that keep their following list hidden, and private accounts, are reported with a clear reason instead of an empty or partial list; a handle nobody owns is reported as such. For third-party accounts, TikTok caps the list and pads short ones with suggested accounts, so check `total` and `truncated`; results are only fully reliable for accounts you can see in full, such as your own.

tiktok.com

Get TikTok user videos

List a TikTok user's videos (newest first) by @username, up to `count`.

tiktok.com

Get TikTok related videos

Get the “you may like” related-video recommendations shown next to a TikTok video (a single ~12-item snapshot, not a paginable list).

Start building not clicking

Get started for free