Social Fetch
TikTok

Search TikTok users

Search TikTok users by keyword.

GET/v1/tiktok/users/search
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
query*stringquery

Search query text for TikTok users.

min 1 chars · max 512 chars

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

Response fields
26

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Users returned for the search query.

datausers[]platform
string

Social platform for this user.

one of: tiktok

datausers[]handle
string

TikTok username without the leading @.

min 1 chars

datausers[]displayName
stringnullable

Public display name shown for the user, when available.

datausers[]bio
stringnullable

Profile biography text, when available.

datausers[]avatarUrl
stringnullable

Profile image URL for the user, when available.

datausers[]verified
boolean

Whether the user is marked as verified.

datausers[]profileUrl
string

Canonical public TikTok profile URL.

min 1 chars

datausers[]privateAccount
booleanoptional

Whether the account is private, when reported.

datausers[]platformUserId
stringoptional

TikTok user id as a string when available.

datausers[]secUid
stringoptional

TikTok stable user identifier for advanced integrations, when available.

Public profile metrics returned with this search result.

datausers[]metricsfollowers
integernullable

Follower count when available.

≥ 0

datausers[]metricsfollowing
integernullable

Following count when available.

≥ 0

datausers[]metricslikes
integernullable

Total profile likes when available.

≥ 0

datausers[]metricsposts
integernullable

Public post count when available.

≥ 0

datatotalUsers
integer

Number of users returned in this response.

≥ 0

Pagination information for the current response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when another page is available.

datapagehasMore
boolean

Whether another page of users is likely available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/tiktok/users/search?query=mrbeast" \
  -H "x-api-key: YOUR_API_KEY"

Responses

User search results for the requested query.

On this page

No Headings