Social Fetch
Get API key
TikTok hub

TikTok User Search API

Discover public TikTok accounts by keyword — handle, bio, verification, and follower metrics in structured JSON, without client scrapers or creator OAuth.

GET /v1/tiktok/users/search

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Creator lists and lead tools often start with a phrase, not a known `@handle`. You want fitness coaches, local restaurants, or brand lookalikes that match a query, then decide which accounts deserve a full profile or video pull. Homegrown TikTok people-search scrapers chase the same signed mobile traffic that breaks video parsers, and the field shapes rarely match the rest of your warehouse.

`GET /v1/tiktok/users/search` takes a required `query` string and returns matching public users in the shared Social Fetch envelope. Each hit can include handle, display name, bio, avatar, verification, profile URL, private-account flag, `platformUserId`, `secUid`, and metrics (followers, following, likes, posts) when TikTok exposes them. `data.totalUsers` is the count for this page; when `data.page.hasMore` is true, pass `data.page.nextCursor` as the `cursor` query param on the next call. Bill from `meta.creditsCharged`.

This route is people / account discovery. Video keyword search is `GET /v1/tiktok/search`. Hashtag search is `GET /v1/tiktok/search/hashtags`. Once you have a handle, use `GET /v1/tiktok/profiles/{handle}` for the full profile card. Pricing for this operation is 1 credit per successful request.

TikTok User Search API FAQ

How do I search TikTok users via API?

Call `GET /v1/tiktok/users/search` with your Social Fetch API key (`x-api-key`) and a required `query` parameter. Read `data.users`, `data.totalUsers`, and `data.page` in the JSON response. Full parameters and examples are in the API docs.

How much does TikTok user search cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth. Each paginated page is a separate billed request.

What fields does each TikTok user search hit include?

Hits can include handle, displayName, bio, avatarUrl, verified, profileUrl, privateAccount, platformUserId, secUid, and metrics such as followers, following, likes, and posts when available. Coverage follows what TikTok shows on public user search.

User search vs video search vs hashtag search?

Use this route to find accounts by keyword. Use `GET /v1/tiktok/search` for free-text video search. Use `GET /v1/tiktok/search/hashtags` for tag discovery. They are separate operations on the TikTok hub.

How does pagination work on TikTok user search?

Each response includes `data.page.nextCursor` and `data.page.hasMore`. When `hasMore` is true, pass `nextCursor` as the `cursor` query param on the next request. Keep the same `query` across pages. The cursor is opaque — do not invent or parse it.

Do I need TikTok OAuth to search users?

No. You authenticate to Social Fetch with an API key. The route reads public user search results for enrichment-style discovery; it does not act on behalf of a logged-in TikTok user.

What should I call after I find a matching handle?

Follow a hit with `GET /v1/tiktok/profiles/{handle}` when you need the full public profile card, then profile videos or followers list routes if you need media or graph edges. Keep `meta.requestId` from the search response if a later enrichment row looks wrong.

Other TikTok endpoints