Open in ChatGPT
Coding with AI?
Connect your agent to our MCP and let it integrate any endpoint for you in one shot.

TikTok Users

Search TikTok users by keyword. Returns username, nickname, bio, follower/following counts, total likes, video count, and verification status. Supports fetching multiple pages in a single API call.

Endpoint

GET /v1/tiktok/users

Price: $0.006 per page Free tier: 50 requests/month

Parameters

Parameter Required Description
query Yes Search keyword (max 500 characters)
pages No Number of pages to fetch, 1-10 (default: 1)

Response Fields

Field Type Description
users array Array of matching user profiles
users[].username string TikTok username (unique ID)
users[].nickname string Display name
users[].user_id string TikTok user ID
users[].bio string Profile bio / signature
users[].verified boolean Whether the user is verified
users[].is_private boolean Whether the account is private
users[].followers integer Number of followers
users[].following integer Number of accounts followed
users[].likes integer Total likes received
users[].video_count integer Number of videos posted
users[].avatar string URL to profile picture
users[].url string Link to the profile
pages integer Number of pages fetched
count integer Total results returned

Example Request

cURL

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

Python

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
}