Search TikTok Users

Find TikTok accounts by name or handle fragment. The endpoint returns a user list for the keyword, with each profile's username, display name, avatar, verification flag and follower figures, which is usually enough to shortlist creators without a second lookup. Cursor and search_id keep paging stable, so even a broad term can be worked through methodically.

Try on Playground

PrimeApi Endpoints > Search Endpoints > Search User

Endpoint Info

Request Method

GET

Request URL

https://api.primeapi.co/search-user?keyword={keyword}&cursor={cursor}&search_id={search_id}

Required Parameters

keyword

Optional Parameters

cursor, search_id

Request Examples

Request Flow

Search User is a single GET call to /search-user, and keyword has to travel with it in the query string. cursor, search_id then shape what comes back. Swap YOUR_API_KEY for your own key and both snippets below run as they are.

Authentication

Header based. Send X-PrimeAPI-Key with every request — there is no OAuth handshake and no token to refresh.

Credits

One Search User call costs 1 credit. Your remaining balance comes back on every response in the X-PrimeAPI-Balance header, so you can watch usage without a second lookup.

cURL

curl -X GET "https://api.primeapi.co/search-user?keyword=cat&cursor=0&search_id=0" \
  -H "X-PrimeAPI-Key: YOUR_API_KEY"

Python - Requests

import requests

url = "https://api.primeapi.co/search-user?keyword=cat&cursor=0&search_id=0"
headers = {"X-PrimeAPI-Key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)

print(response.json())
print("Credits left:", response.headers.get("X-PrimeAPI-Balance"))

Endpoint Response

Example URL

https://api.primeapi.co/search-user?keyword=cat&cursor=0&search_id=0

Content Type

JSON

Example Response

{
    "type": 1,
    "user_list": [
        {
            "user_info": {
                "uid": "204421599687856128",
                "nickname": "cat",
                "signature": "\ud83c\udccf\ud83e\ude84\ud83c\udf08\ud83c\udf7f\n\ud835\udfef,\ud835\udfed\ud835\ude48? \ud83e\udd21\n\ud835\ude56\ud835\ude68\ud835\ude68\ud835\ude5e\ud835\ude68\ud835\ude69\ud835\ude56 \ud835\ude56\ud835\ude66\ud835\ude6a\ud835\ude5e \ud835\ude68\ud835\ude5a\ud835\ude67\ud835\ude5e\ud835\ude5a\ud835\ude68 \ud835\ude5a \ud835\ude5b\ud835\ude5e\ud835\ude61\ud835\ude62\ud835\ude5a\ud835\ude68 \ud83d\udc47",
                "avatar_thumb": {
                    "uri": "tos-maliva-avt-0068/7edcf2bf975a9ecf8680c494342deef6",
                    "url_list": [
                        "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7edcf2bf975a9ecf8680c494342deef6~c5_100x100.webp?biz_tag=tiktok_user.user_cover&lk3s=30310797&nonce=85504&refresh_token=44737a0853c6918e06664b273ea1a671&shcp=-&shp=30310797&x-expires=1737244800&x-signature=mSUExOSQ2L8gX%2FDM2JfaimEOz5U%3D",
                        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7edcf2bf975a9ecf8680c494342deef6~c5_100x100.webp?biz_tag=tiktok_user.user_cover&lk3s=30310797&nonce=82846&refresh_token=37e060c812f770a88bfcfc776b1b3061&shcp=-&shp=30310797&x-expires=1737244800&x-signature=kxvram%2B2qc%2B00IQAajp3Gyog51c%3D",
                        "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7edcf2bf975a9ecf8680c494342deef6~c5_100x100.jpeg?biz_tag=tiktok_user.user_cover&lk3s=30310797&nonce=31270&refresh_token=00b6fa100cdd6c603bdbfbcac33eb1cd&shcp=-&shp=30310797&x-expires=1737244800&x-signature=ltJ6%2BJ67Plksfk6XIR2X5Go20Ps%3D"
                    ],
                    "width": 720,
                    "height": 720,
                    "url_prefix": null
                },
                "follow_status": 0,
                "follower_count": 3000000,
                "custom_verify": "",
                "unique_id": "catziinho",
                "room_id": 0,
                "enterprise_verify_reason": "",
                "followers_detail": null,
                "platform_sync_info": null,
                "geofencing": null,
                "cover_url": null,
                "item_list": null,
                "type_label": null,
                "ad_cover_url": null,
                "relative_users": null,
                "cha_list": null,
  ... (truncated)

Show full response

Related Endpoints

More TikTok Search Endpoints

Search TikTok (Top Results) Search TikTok Videos Search TikTok Live Get TikTok Searched Suggest

View all Search Endpoints

Contact

You can contact us via Telegram or Gmail

@primeapi_co

Gmail

primeapico@gmail