TikTok Search Users API

Endpoint

GET /v1/tiktok/users

Parameters

query *

Search keyword (max 500 characters)

pages

Number of pages to fetch, 1-10 (default: 1)

Response fields

users

Array of matching user profiles

username

TikTok username (unique ID)

nickname

Display name

user_id

TikTok user ID

bio

Profile bio / signature

verified

Whether the user is verified

is_private

Whether the account is private

followers

Number of followers

following

Number of accounts followed

likes

Total likes received

video_count

Number of videos posted

avatar

URL to profile picture

url

Link to the profile

pages

Number of pages fetched

count

Total results returned

Example Request

curl "https://apidirect.io/v1/tiktok/users?query=cooking&pages=1" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/tiktok/users",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "cooking",
        "pages": 1
    }
)
print(response.json())

Example Response

{
  "users": [
    {
      "username": "cookingwithshereen",
      "nickname": "Shereen Pavlides",
      "user_id": "6812601268610257926",
      "bio": "Chef | Author | TV Host",
      "verified": true,
      "is_private": false,
      "followers": 483313,
      "following": 47,
      "likes": 3090163,
      "video_count": 728,
      "avatar": "https://p16-sign.tiktokcdn-us.com/.../photo.webp",
      "url": "https://www.tiktok.com/@cookingwithshereen"
    }
  ],
  "pages": 1,
  "count": 30
}

Frequently asked questions

What user data is returned?

Each result includes username, nickname, user ID, bio, verification status, privacy status, follower/following counts, total likes, video count, avatar URL, and profile link.

How many users are returned per page?

Each page returns up to 30 user results. You can fetch up to 10 pages (300 users) in a single request.

Does this include engagement metrics?

Yes, each user profile includes follower count, following count, total likes received, and total videos posted.

How does pricing work?

You only pay for successful requests. The TikTok Search Users API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.