Unofficial TikTok User Search API
GET/api/v1/search_users· paginated
Search users/accounts (one page per call, cursor-paginated). Filter by followers, verified accounts, or match usernames only.
| Parameter | Description | |
|---|---|---|
query | required | What to search for. |
followers | optional | Only accounts with this many followers: 0-1k, 1k-10k, 10k-100k, or 100k+. |
verified | optional | true to return only verified accounts. |
match | optional | username to match the query against usernames (not display names). |
cursor | optional | Page cursor. Omit (or 0) for the first page; pass the next_cursor from the previous response. Keep the same filters when paging. |
format | optional | Omit for raw account objects (default). clean for a trimmed subset (username, nickname, followers, verified, avatar). |
Returns
query, next_cursor, has_more, count, and a results array of account objects (raw by default, trimmed with format=clean).
Example Request
https://dev.omar-thing.site/api/v1/search_users?query=messi&followers=100k%2B&verified=true&match=username&cursor=0&format=clean&key=YOUR_API_KEY
Example Response
{
"data": {
"count": 15,
"has_more": true,
"next_cursor": "15",
"query": "messi",
"results": [
{
"avatar": "https://...",
"followers": 68142884,
"nickname": "fcbarcelona",
"profile_url": "https://www.tiktok.com/@fcbarcelona",
"sec_uid": "MS4w...",
"user_id": "67...",
"username": "fcbarcelona",
"verified": true
},
{
"...": "more (format=clean shown)"
}
]
},
"status": "success"
}Sends a live request using your API key above.
More Search endpoints
- Unofficial TikTok Video Search API — Search videos (one page per call, cursor-paginated). Filter by
dateand sort bylikesornewest. - Unofficial TikTok Photo Search API — Search photo/slideshow posts (one page per call, cursor-paginated).
- Unofficial TikTok Hashtag Search API — Search hashtags (one page per call, cursor-paginated).
- Unofficial TikTok Place Search API — Search places/POIs (venues, landmarks, restaurants). Results are localized to the
countryyou pass (ISO-2). One page per call, cursor-paginated. - Unofficial TikTok Music Search API — Search sounds/music (one page per call, cursor-paginated).
- Unofficial TikTok Search Suggestions API — Search autocomplete — the suggestions shown while you type.
- Unofficial TikTok Related Searches API — Related search terms suggested under a video ("others searched for"). Add
queryto steer them toward a topic.