Social Fetch
Start for freeStart free
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 Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

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. See the API docs for parameters and examples.

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. Autocomplete query suggestions are GET /v1/tiktok/search/suggestions. 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 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