Search users — TikTok API

Searches TikTok for user profiles matching a query. Fixed page size of 10 (platform limit). Returns profile details including follower counts and verification status.

Get free API key View the docs

GET/v1/tiktok/search/users1 credit per request

Example response200OK

{
  "data": {
    "@context": [
      "https://www.w3.org/ns/activitystreams#",
      "https://konbiniapi.com/ns/social#"
    ],
    "type": "OrderedCollectionPage",
    "partOf": "https://api.konbiniapi.com/v1/tiktok/search/users",
    "totalItems": 1309,
    "cursor": null,
    "nextCursor": "1772217402000",
    "next": "https://api.konbiniapi.com/v1/tiktok/search/users?query=khaby&cursor=1772217402000&count=30",
    "itemCount": 30,
    "orderedItems": [
      {
        "type": "Person",
        "id": "https://www.tiktok.com/@khaby.lame",
        "url": "https://www.tiktok.com/@khaby.lame",
        "entityId": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
        "name": "Khabane Lame",
        "preferredUsername": "khaby.lame",
        "summary": "Just a guy who reacts",
        "attachment": [
          {
            "type": "Link",
            "href": "https://linktr.ee/khaby.lame",
            "rel": "preferred"
          }
        ],
        "published": "2020-03-15T00:00:00.000Z",
        "isPrivate": false,
        "isVerified": true,
        "isLive": false,
        "hasLikes": true,
        "hasPlaylists": true,
        "followerCount": 160300000,
        "followingCount": 85,
        "language": "en",
        "likeCount": 2600000000,
        "likedCount": 5300,
        "mediaCount": 1309,
        "icon": {
          "type": "Image",
          "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
          "width": 576,
          "height": 1024
        },
        "image": [
          {
            "type": "Image",
            "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
            "width": 576,
            "height": 1024
          }
        ]
      }
    ]
  }
}

Make the request.

One authenticated GET to /v1/tiktok/search/users. Authentication and error conventions stay consistent across endpoints. This page shows the path, parameters, response shape, limits, and credit rule for this operation.

Built for

Niche creator discovery by keyword, topic, or industry
Competitor account identification and prospecting lists
Micro-influencer discovery for targeted campaigns

Full reference for this endpoint

const response = await fetch("https://api.konbiniapi.com/v1/tiktok/search/users", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});

const data = await response.json();

Parameters3

queryrequiredIn · QueryType · stringSearch query
countIn · QueryType · integerPage size (fixed at 10 by the platform)10–10default 10
cursorIn · QueryType · stringPagination cursordefault 0

What you will probably call next.

The TikTok endpoints around this one — the same object at a different depth, or the same kind of read.

All TikTok endpoints Browse every platform

Try it on your own data.

Get a free API key and make this request in minutes. Failed and timed-out requests are automatically refunded.

Get free API key Endpoint reference